| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| dragengine:modules:dragonscript:simpleconversation [2025/03/13 23:04] – [Translations] dragonlord | dragengine:modules:dragonscript:simpleconversation [2025/06/10 13:07] (current) – [File Format (*.desconvo)] dragonlord |
|---|
| |
| ====== Simple Conversation ====== | ====== Simple Conversation ====== |
| | |
| | <WRAP center 100%> |
| | <WRAP center box 1050px> |
| | {{ youtube>W6Pd6kT94Ro?1000x591 }} |
| | <WRAP centeralign>\\ |
| | Video explaining what simple conversation are, what they can be used for and how they are created. Shown using Epsylon game project which uses simple conversation a lot.</WRAP> |
| | </WRAP> |
| | </WRAP> |
| |
| Simple conversations provide a quicker and easier way to create simple conversations compared to the [[gamedev:deigde:editors:conversation|IGDE Conversation Editor]]. In contrary to regular conversations simple conversations are created using XML files. Yet they are still regular conversations but using an XML syntax and a converter which creates regular conversations for you. It is important to note that simple conversations already require a regular conversation to be present. The reason is that simple conversation reuse various definitions present inside regular conversations like camera shots, gestures, look-at targets as well as pre-made topics for reuse. In the examples below it is expected such a regular conversation is present and contains the required camera shots, gestures and look-at targets. | Simple conversations provide a quicker and easier way to create simple conversations compared to the [[gamedev:deigde:editors:conversation|IGDE Conversation Editor]]. In contrary to regular conversations simple conversations are created using XML files. Yet they are still regular conversations but using an XML syntax and a converter which creates regular conversations for you. It is important to note that simple conversations already require a regular conversation to be present. The reason is that simple conversation reuse various definitions present inside regular conversations like camera shots, gestures, look-at targets as well as pre-made topics for reuse. In the examples below it is expected such a regular conversation is present and contains the required camera shots, gestures and look-at targets. |
| ====== File Format (*.desconvo) ====== | ====== File Format (*.desconvo) ====== |
| |
| The simple conversation file format is recognized by the LoadSimpleConversation script class. The file is an XML file with a simple structure to define a simple conversation using XML. | The simple conversation file format is recognized by the LoadSimpleConversation script class. The file is an XML file with a simple structure to define a simple conversation using XML. See [[https://lordofdragons.github.io/dragengine/artifacts/xmlschema/dragengine/latest/simpleConversation.xsd|XML Schema]] for use with editors like VSCode. |
| |
| <uml> | <uml> |
| * ''noCamera'': Do not change camera. | * ''noCamera'': Do not change camera. |
| * ''noCameraNoDelay'': Do not change camera and use 0 second delay for speak. | * ''noCameraNoDelay'': Do not change camera and use 0 second delay for speak. |
| | * ''sound'': Path of sound file to play. This is typically used to play voice audio but can be also used for uttering and mumbling if no voice audio is used. Optional. |
| </WRAP>|0..N|-| | </WRAP>|0..N|-| |
| |a|<WRAP>Short version of ''actor'' tag. Attributes: | |a|<WRAP>Short version of ''actor'' tag. Attributes: |
| * ''i'': Same as ''id'' attribute of ''actor'' tag. Optional. | * ''i'': Same as ''id'' attribute of ''actor'' tag. Optional. |
| * ''m'': Same as ''mode'' attribute of ''actor'' tag. Optional | * ''m'': Same as ''mode'' attribute of ''actor'' tag. Optional |
| | * ''s'': Same as ''sound'' attribute of ''actor'' tag. Optional |
| </WRAP>|0..N|-| | </WRAP>|0..N|-| |
| |gesture|<WRAP>Add gesture to play back. Replaces gestures defined in active actor definition. Attributes: | |gesture|<WRAP>Add gesture to play back. Replaces gestures defined in active actor definition. Attributes: |
