Skip to content

Commit

Permalink
Merge pull request #11 from Silver-Ore-Team/feature/wiki
Browse files Browse the repository at this point in the history
Replace documentation in README with links to wiki
  • Loading branch information
muczc1wek authored Oct 7, 2024
2 parents 835d1c3 + 7f44f14 commit c97137c
Showing 1 changed file with 18 additions and 46 deletions.
64 changes: 18 additions & 46 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
# zMultilogue
Multi-NPC dialogue system for Gothic,
based on the solution form [AFSP Trialogue package](https://github.com/Bad-Scientists/AF-Script-Packet/blob/main/Standalone-Packages/G12-Trialogue/trialogue.d).
zMultilogue is a Multi-NPC dialogue system for Gothic 1 and Gothic 2 NotR, based on the solution form [AFSP Trialogue package](https://github.com/Bad-Scientists/AF-Script-Packet/blob/main/Standalone-Packages/G12-Trialogue/trialogue.d).
Its goal is to replace Trialoue packages based on [Ikarus](https://github.com/Lehona/Ikarus) and [LeGo](https://github.com/Lehona/LeGo/tree/dev) with an union-based plugin.

## Features
- System for creating dialogues with multiple NPCs that doesn't fuck up AI queue
- Script interface based on the LeGo [Trialogue package](https://github.com/Lehona/LeGo/blob/dev/Trialoge.d) (easy to port dialogues)
- Automatic increasing of dialog-box display distance if NPC is too far

## ToDo

Expand All @@ -9,52 +14,19 @@ based on the solution form [AFSP Trialogue package](https://github.com/Bad-Scien
- [ ] Custom camera system
- [x] Gothic 1 compatibility

## Usage
1. Download `zMultilogue.vdf` and place it inside `<GOTHIC_ROOT>/Data` with Union installed to automatically load the plugin at the start of the game.

2. Copy the `ZS_MULTILOGUE` routine from [`_externals/zMultilogue.d`](https://github.com/Silver-Ore-Team/zMultilogue/blob/main/_externals/zMultilogue.d) into any file parsed by the game.

3. Use the plugin's externals to create multilogues :smile:

## Example
The following example demonstrates how to create a simple multilogue with two NPCs.
```cpp
instance DIA_TEST_ZMUL(C_INFO)
{
npc = NONE_100_Xardas;
nr = 0;
condition = DIA_TEST_ZMUL_Condition;
information = DIA_TEST_ZMUL_Info;
permanent = FALSE;
description = "Multilogue test";
};

FUNC INT DIA_TEST_ZMUL_Condition()
{
return TRUE;
};

FUNC VOID DIA_TEST_ZMUL_Info()
{
var C_NPC diego; diego = Hlp_GetNpc(PC_Thief_NW);
var C_NPC xardas; xardas = Hlp_GetNpc(NONE_100_Xardas);
zMul_Invite(diego);
zMul_Start();
AI_Output(other, self, "DIA_TEST_ZMUL_15_00"); //I found your gold!
zMul_Next(diego);
AI_Output(self, other, "DIA_TEST_ZMUL_11_01"); //Great. Show me.
zMul_Next(xardas);
AI_Output(self, other, "DIA_TEST_ZMUL_14_02"); //What gold?
AI_Output(other, self, "DIA_TEST_ZMUL_15_03"); //None of your business.
AI_Output(self, other, "DIA_TEST_ZMUL_14_04"); //Okay. I will be in the tower.
zMul_Next(diego);
AI_Output(self, other, "DIA_TEST_ZMUL_11_05"); //Give me the gold now.
zMul_Finish();
};
```
## Documentation
Documentation of a project is provided a GitHub wiki.

- [Home](https://github.com/Silver-Ore-Team/zMultilogue/wiki)
- [Getting Started](https://github.com/Silver-Ore-Team/zMultilogue/wiki/Getting-Started)
- [Script Interface](https://github.com/Silver-Ore-Team/zMultilogue/wiki/Script-Interface)

## Support

If you have found a bug in zMultilogue, please [create an issue](https://github.com/Silver-Ore-Team/zMultilogue/issues/new).

### Discord

You can contact the authors and maintainers on Discord.
Look for [@muczciwek](https://discordapp.com/users/667438896594026517).

Expand All @@ -73,7 +45,7 @@ https://discord.gg/4E2CeQAeWS

zMultilogue is licensed under [MIT license](LICENSE) excluding some dependencies.

[union-api](https://gitlab.com/union-framework/union-api) and [gothic-api](https://gitlab.com/union-framework/gothic-api) are licensed under [GNU GENERAL PUBLIC LICENSE V3](https://gitlab.com/union-framework/union-api-/blob/main/LICENSE).
[union-api](https://gitlab.com/union-framework/union-api) and [gothic-api](https://gitlab.com/union-framework/gothic-api) are licensed under [GNU GENERAL PUBLIC LICENSE V3](https://gitlab.com/union-framework/union-api/blob/main/LICENSE).


GothicVDFS 2.6 [Copyright (c) 2001-2003, Nico Bendlin, Copyright (c) 1994-2002, Peter Sabath / TRIACOM Software GmbH](vdf/License.txt)

0 comments on commit c97137c

Please sign in to comment.