Differences

This shows you the differences between two versions of the page.

--- dcx:event_library [2016/01/25 12:39] – vic
+++ dcx:event_library [2026/06/22 12:21] (current) – external edit 127.0.0.1
@@ Line 53: / Line 53: @@
 Make sure you have the advanced editor enabled. In the main menu click on the 'advanced editor' button and specify a smallest map size as possible.
+{{:dcx:evlib7.jpg|}}
+Then once in the advanced editor go to the settings tab and then to the 'Import and Other settings' tab and set the ruleset to 'VR'
+This is important as it tells the Simple editor that your event library is compatible with the default VR ruleset.
 {{:dcx:evlib1.jpg|}}
-Then once in the advanced editor go to the lib tabsheet.
+Then go to the lib tabsheet.
 {{:dcx:evlib2.jpg|}}
@@ Line 80: / Line 86: @@
 In the event editor you do the following.
-. Add a new event
+. Add a new event.
 . Assign the event to your "Command Problems Library".
@@ Line 91: / Line 97: @@
 Then I script the following code:
+<code>
+)    ' event code is going to come here
+)    SETVAR: TempVar1 = CheckTurn
+)    '
+)    SETVAR: TempVar2 = CheckLibVarRegime(TempVar1, 'Command Problems Library', 'CommandProblemsEnabled')
+)    SETVAR: TempVar3 = CheckLibVarRegime(TempVar1, 'Command Problems Library', 'CommandProblemsChance')
+)    SETVAR: TempVar4 = CheckLibVarRegime(TempVar1, 'Command Problems Library', 'CommandProblemsFixedAPLoss')
+)    SETVAR: TempVar5 = CheckLibVarRegime(TempVar1, 'Command Problems Library', 'CommandProblemsRandomAPLoss')
+)    '
+)    SETVAR: TempString1 = ''
+)    '
+)   CHECK: TempVar2 > 0
+)     ' If CommandProblemsEnabled=Yes we arrive here
+)     LOOPER: TempVar6 FROM 0 TO CheckTotalUnits
+)       '
+)       CHECK: CheckUnitHistoricalID(TempVar6) > 0
+)         CHECK: CheckUnitIsHQ(TempVar6) > 0
+)           CHECK: CheckUnitOwner(TempVar6) == TempVar1
+)             '
+)             SETVAR: TempVar7 = CheckRandomPercent
+)             CHECK: TempVar3 > TempVar7
+)               ' If random roll 0-100 is below CommandProblemsChance for this HQ a command problem occures
+)               '
+)               SETVAR: TempVar10 = TempVar5
+)               SETVAR: TempVar10 * CheckRandomPercent
+)               SETVAR: TempVar10 / 100
+)               SETVAR: TempVar10 + TempVar4
+)               SETVAR: TempVar11 = 0
+)               SETVAR: TempVar11 - TempVar10
+)               ' tempvar11 has the AP loss calculcated for units under this HQ (or hq itself)
+)               SETVAR: TempString1 + CheckUnitName(TempVar6)
+)               SETVAR: TempString1 + ' has suffered '
+)               SETVAR: TempString1 + TempVar11
+)               SETVAR: TempString1 + 'AP due to command problems.'
+)               SETVAR: TempString1 + ReturnCRLF
+)               '
+)               LOOPER: TempVar8 FROM 0 TO CheckTotalUnits
+)                 '
+)                 SETVAR: TempVar9 = 0
+)                 CHECK: CheckUnitHQ(TempVar8) == TempVar6
+)                   SETVAR: TempVar9 = 1
+)                 END CHECK
+)                 CHECK: CheckUnitIsHQ(TempVar8) > 0
+)                   SETVAR: TempVar9 = 0
+)                 END CHECK
+)                 CHECK: TempVar6 == TempVar8
+)                   SETVAR: TempVar9 = 1
+)                 END CHECK
+)                 '
+)                 CHECK: TempVar9 == 1
+)                   ' This unit is suffering Command Problems
+)                   EXECUTE: ExecUnitApModify(TempVar8, TempVar11, -1, -1)
+)                 END CHECK
+)                 '
+)               END LOOPER
+)               '
+)             END CHECK
+)             '
+)           END CHECK
+)         END CHECK
+)       END CHECK
+)       '
+)     END LOOPER
+)     '
+)     CHECK: CheckStringLength(TempString1) > 0
+)       EXECUTE: ExecMessage(TempVar1, -1, -1, -1)
+)     END CHECK
+)     '
+)   END CHECK
+</code>
+===Step D: Save the event library===
+{{:dcx:evlib4.jpg|}}
+Save your work with the .dcxevlib extension.
+And thats it.
+In the final Step E i am just going to show how it looks like to the end-user when he loads your event library.
+===Step E: In the Simple Editor & In-Game===
+{{:dcx:evlib6.jpg|}}
+In the Simple Editor you or an end-user can load your event library and configure it (as shown in the example above) for one or more regimes.
+Also note that the contents of the library are correctly listed as 4 libvars and 1 event.
+Then finally when in-game when in-game the player will get reports like this one:
+{{:dcx:evlib8.jpg|}}
+It is important to check if your event libraries work properly before distributing them.
+Don't forget to use the description fields for the library itself and its libvars and/or stringlists (tables for end-user).
+Thats it! A working and tested library ready for use or sharing with other designers.
+===Tutorial library===
+Here you can download the library created in the tutorial above:
+[[http://www.vrdesigns.nl/privatepatch/CommandProblems.zip|CommandProblems.zip]]