World Primer

# Description World Primer can automatically run a set of commands when certain "events" happen, such as when a new world is first created, when a world is loaded, when a dimension is loaded, when a player joins the game, quits the game, dies or respawns. There are also scheduled/periodic commands. # Configuration All of the configs can also be configured via the in-game config menu. **Read the comments in the configuration file.** It has all the possible command substitutions listed, as well as lots of other information. Many of the substitutions and command prefixes have changed between mod versions, and later mod versions have more config/event types and string substitutions. The config comments are the easiest way to see the correct information for that particular mod version. **Note:** None of the commands in the configuration file should have the slash prefix! The slash is only required in commands sent via the chat or the server console, to know that the message is not a chat message but a command. One notable exception of course would be World Edit commands, as they normally use the double slash via chat, so they should have a single slash in the configuration file. ## Commands configuration The commands to run at various events are set in the following config options. **Note:** Older mod versions don't have all of these yet. * `dimensionLoadingCommands` - commands to run each time a dimension gets loaded * `earlyWorldCreationCommands` - Commands to run on initial world creation, before the spawn chunks have been generated or loaded. If dimension load tracking is enabled, then this happens even before any dimensions have been loaded/initialized yet. * `earlyWorldLoadingCommands` - Commands to run every time the world gets loaded (i.e. when the server is starting). These are run when the server is starting, before any worlds have been loaded. * `playerChangedDimensionEnterCommands` - Commands to run when (= after) a player entered into another dimension. Note that these will NOT run when a player joins the game or respawns after dying. * `playerChangedDimensionLeaveCommands` - Commands to run when a player leaves a dimension while changing dimensions. **Note:** These commands will run **after** the player is already in the new dimension! **Note:** These will **not** run when a player leaves the game/server. * `playerDeathCommands` - Commands to run when a player dies * `playerJoinCommands` - Commands to run when a player joins (connects to) the server * `playerQuitCommands` - Commands to run when a player disconnects from the server * `playerRespawnCommands` - Commands to run when a player respawns after dying * `postWorldCreationCommands` - Commands to run on initial world creation, after the spawn chunks have been generated and loaded. * `postWorldLoadingCommands` - Commands to run every time the world gets loaded (i.e. when the server is starting). These are run when the server has started and the overworld spawn chunks have been loaded. * `timedCommands` - Commands to run based on the world tick/time. * Must be in the format: `worldprimer-timed-command <time> <dimension> <command>`, where `<time>` is the total world time in ticks when the command should run. * The time can be prefixed with a `%` to make it run periodically, with that interval (basically a modulo). * With the periodic time, you can also use offsets, like so: ``` worldprimer-timed-command %1200-80 0 say Something happens in 4 seconds! worldprimer-timed-command %1200 0 say Something happens now! worldprimer-timed-command %1200+80 0 Say something happened 4 seconds ago! ``` There are also separate config options to enable or disable all of these in the `Toggles` category. Those options allow you to disable the commands without having to remove them or comment them out if you want to temporarily disable them. ## Other configs * `enableDebugLogging` - Prints log messages from the various events, and also prints any commands that are attempted to be executed, so that it's easy to track what happens and when * `enableDimensionLoadTracking` / `enableDataTracking` - Enables tracking and saving the number of times dimensions have loaded, how many times the server has started, how many times players have joined, died etc. This is needed for all the count based prefixes to work. **It's highly encouraged** to use the `enableDebugLogging` logging option while testing things! # Command prefixes There are a few different command prefixes/filters for running commands only in specific situation, like in specific dimensions, or only at specific times etc. ## worldprimer-dim-command The dimension loading commands can be targeted to only run when a specific dimension loads, by using this command prefix: ``` worldprimer-dim-command <dim id> <the actual command> ``` So for example: ``` worldprimer-dim-command 1 say The End dimension has loaded! ``` If you would just have a command without the prefix in `