The EventSystem plugin offers flexible configuration that allows you to tailor the operation of the event system to your server's specific requirements. Below is a guide to the available configuration options.
The EventSystem plugin is designed to work with a PostgreSQL database, allowing you to effectively manage event data, player scores and other system elements. Configure the following options to ensure proper communication with the PostgreSQL database:
To ensure a seamless integration, make sure that the database is available at the specified address and port, and that the credentials are correct. The plugin uses this information to connect to the database and perform operations related to event management and player scoring.
The plugin allows you to create a variety of events, each with its own configuration set. Examples of events and their settings:
SpecialEventSettings, SpecialTwoEventSettings, ArenaTeamFightSettings: each of these configuration objects allows you to detail the parameters of an event, such as duration, number of participants, victory points, and more. (these are just examples with time this may change.)
<?xml version="1.0" encoding="utf-8"?>
<EventSystemConfig xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<DebugMode>true</DebugMode>
<isLobby>false</isLobby>
<DefaultOwnerGrid>144115188075855881</DefaultOwnerGrid>
<EnableActiveEventsLCDManager>true</EnableActiveEventsLCDManager>
<ActiveEventsLCDManagerTagName>ACTIVE EVENTS</ActiveEventsLCDManagerTagName>
<EnableAllEventsLCDManager>true</EnableAllEventsLCDManager>
<AllEventsLcdTagName>ALL EVENTS</AllEventsLcdTagName>
<EventPrefix>EVENT SYSTEM</EventPrefix>
<UseDatabase>true</UseDatabase>
<DatabaseHost>localhost</DatabaseHost>
<DatabasePort>5432</DatabasePort>
<DatabaseName>postgres</DatabaseName>
<DatabaseUsername>postgres</DatabaseUsername>
<DatabasePassword>1234</DatabasePassword>
</EventSystemConfig><?xml version="1.0" encoding="utf-8"?>
<PackRewardsConfig xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<RewardSets>
<RewardSet>
<Name>StarterPack</Name>
<Items>
<PackRewardItem>
<ItemTypeId>MyObjectBuilder_Ingot</ItemTypeId>
<ItemSubtypeId>Iron</ItemSubtypeId>
<Amount>100</Amount>
<ChanceToDrop>100</ChanceToDrop>
</PackRewardItem>
<PackRewardItem>
<ItemTypeId>MyObjectBuilder_Component</ItemTypeId>
<ItemSubtypeId>Construction</ItemSubtypeId>
<Amount>50</Amount>
<ChanceToDrop>100</ChanceToDrop>
</PackRewardItem>
</Items>
<CostInPoints>100</CostInPoints>
</RewardSet>
<RewardSet>
<Name>AdvancedPack</Name>
<Items>
<PackRewardItem>
<ItemTypeId>MyObjectBuilder_Ingot</ItemTypeId>
<ItemSubtypeId>Uranium</ItemSubtypeId>
<Amount>5</Amount>
<ChanceToDrop>50</ChanceToDrop>
</PackRewardItem>
<PackRewardItem>
<ItemTypeId>MyObjectBuilder_Component</ItemTypeId>
<ItemSubtypeId>Detector</ItemSubtypeId>
<Amount>10</Amount>
<ChanceToDrop>75</ChanceToDrop>
</PackRewardItem>
</Items>
<CostInPoints>500</CostInPoints>
</RewardSet>
</RewardSets>
</PackRewardsConfig><?xml version="1.0" encoding="utf-8"?>
<ItemRewardsConfig xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<IndividualItems>
<IndividualRewardItem>
<ItemTypeId>MyObjectBuilder_Ingot</ItemTypeId>
<ItemSubtypeId>Silver</ItemSubtypeId>
<Amount>10</Amount>
<CostInPoints>50</CostInPoints>
</IndividualRewardItem>
<IndividualRewardItem>
<ItemTypeId>MyObjectBuilder_Ore</ItemTypeId>
<ItemSubtypeId>Gold</ItemSubtypeId>
<Amount>5</Amount>
<CostInPoints>75</CostInPoints>
</IndividualRewardItem>
</IndividualItems>
</ItemRewardsConfig>| Command | Description | Usage |
| help | Shows help for commands available to you. | !event help |
| points | Check your points. | !event points |
| events | Displays active and upcoming events. | !event events |
| transfer | Initiate a point transfer. | !event transfer “100” |
| claim | Complete a point transfer using a transfer code. | !event claim “Transfer Code” |
| join | Join an active event. | !event join “Event Name” |
| leave | Leave a specified event. | !event leave “Event Name” |
| buy | Buy rewards with points or list available rewards. | !event buy “Award Name” |
| listrewards | Displays available rewards | !event listrewards |
| Command | Description | Usage |
| modifypoints | Add or remove points from a player's account. | !eventAdmin modifypoints “SteamId” “100” |
| refreshblocks | Refreshes the list of screens for updates. | !eventAdmin refreshblocks |
| spawngird | Loads and spawns a grid from a specified file in the 'prefab' folder at a specified position. | !eventAdmin spawngird “FileName” “X" “Y” “Z” |
| listnpcs | Displays information about all NPCs on the server. | !eventAdmin listnpcs |
The EventSystem plugin offers the advanced ability to create and manage in-game events, allowing server administrators and modding developers to customize the player experience. With flexible configuration options, you can design events that best fit the needs of your community - from simple competitions to complex multi-stage scenarios.
To learn more about creating and configuring your own events, visit our event creation page for detailed instructions, tips and best practices.
If you need help, have questions about the plugin or want to join the community, welcome to our Discord server! This is the best place to get support, share feedback and tips with other users. DISCORD