**Batch commands: A scripting engine that does what it intends to do**<\/p>\n
Skript is a little too complex for most usage cases, so I made this plugin to be able to execute a series of commands from a file quickly.<\/p>\n
For instance, you are setting up chunky. Normally you’d do:
\n`\/chunky world world` `\/chunky radius 1500` `\/chunky shape circle` and `\/chunky start`
\nBut what if you are doing this across multiple servers and are lazy enough to not want to do so? Here’s what I aim to solve: repetative mannual labor.
\nWe can now create a file within the `\/plugins\/BatchCommands\/batches` folder named `chunky.batch`
\nInside, it would look like this:
\n“`
\nchunky world world
\nchunky radius 1500
\nchunky shape circle
\nchunky start
\n“`
\nNow all you have to do is type `\/filebatch chunky.batch` (Live tab completion fully supported).<\/p>\n
Now, this is almost all the features anyone would possibly need in their lifetime. But what if we want more? What if I want to wait one second (twenty ticks) before starting the chunky worldgen?
\nThe script will use our decorator `!sleep ticks`
\n“`
\nchunky world world
\nchunky radius 1500
\nchunky shape circle
\n!sleep 1
\nchunky start
\n“`
\nNow this plugin will execute the first three commands and then wait 20 ticks (one second) to perform the subsequent command.<\/p>\n
Need help with the syntax?
\nDon’t worry, we have an extensive linting system that is highly configurable.<\/p>\n
Configuration options will be provided below<\/p>\n “`yaml # Enable this to see more detailed logs in the console. # ————————————————– # # Stop on Error: true or false # Allow OP Commands: true or false # Command Blacklist: A list of commands that can NEVER be run. lint-engine: scripting: “`<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":" A simple scripting plugin that does what it is supposed to do.<\/p>\n","protected":false},"featured_media":26290,"template":"","meta":{"_minecraft_slug":"batchcommands","_minecraft_project_id":"J3a84vy4","_minecraft_author":"Earth1283","_minecraft_license":"MIT","_minecraft_downloads":84,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"batchcommands.zip","_minecraft_size_bytes":32623,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:07:51.383200Z","_minecraft_date_created":"2025-08-25T07:29:18.998583Z","_minecraft_date_modified":"2025-08-26T14:39:38.205807Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/batchcommands","_minecraft_icon_attachment_id":26290,"_minecraft_imported_at":"2026-06-01T09:47:03+00:00","_minecraft_import_hash":"7e8bd9f8a1b9841bf3442eee906772e5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,122,126,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-26289","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-magic","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nconfig.yml<\/summary>\n
\n# ————————————————– #
\n# BatchCommands Configuration #
\n# ————————————————– #<\/p>\n
\n# This is useful for server administrators for debugging purposes.
\ndebug-mode: false<\/p>\n
\n# Execution Settings #
\n# ————————————————– #
\n# WARNING: Modifying these settings can create #
\n# potential security risks. Understand the #
\n# implications before changing them. #
\n# ————————————————– #
\nexecution:
\n # Default Executor: CONSOLE or SENDER
\n # Determines who runs the commands inside the batch file by default.
\n # – CONSOLE: (Default, Safest) All commands are run by the server console.
\n # – SENDER: (RISKY) Commands are run by the player who initiated the \/filebatch command.
\n # This is dangerous if non-admins have the permission to run this command,
\n # as they could execute commands with their own (potentially limited) permissions.
\n default-executor: CONSOLE<\/p>\n
\n # If true, the batch execution will halt immediately if any command fails.
\n # If false (RISKY), the batch will continue even if a command fails, which can lead to
\n # unexpected behavior or incomplete actions.
\n stop-on-error: true<\/p>\n
\n # If false (Default, Safest), commands like \/op, \/deop, etc., are blocked from running
\n # through this plugin, regardless of the executor.
\n # If true (EXTREMELY RISKY), these commands are allowed. If ‘default-executor’ is SENDER,
\n # a player could write a batch file with “op
\n allow-op-commands: false<\/p>\n
\n # This is a final safeguard against catastrophic commands.
\n # Commands should be listed without the slash. e.g., “stop” not “\/stop”.
\n command-blacklist:
\n – “stop”
\n – “reload”
\n – “rl”
\n – “restart”
\n – “plugman”<\/p>\n
\n # Lint engine mode
\n # BEFORE – check before executing the script
\n # AS_WE_GO – check as we go (less thorough, but faster startup)
\n engine-mode: BEFORE
\n checking-order:
\n – “EMPTY_FILE” # Checks if the file contains any executable lines.
\n – “ILLEGAL_CMD” # Checks for blacklisted or disabled OP commands.
\n – “UNKNOWN_DECORATOR” # Checks for decorators that don’t exist (e.g., !fly).
\n – “SYNTAX_ERRS” # Checks for malformed decorators (e.g., !sleep without a number).
\n – “RECURSIVE_EXECUTION” # Checks if the file tries to call itself.
\n max-checking-time: 1000 #Max checking time for lint engine, if it exceeds this we will respect the next setting
\n # Possible options:
\n # STOP – Stop the execution
\n # TRY_AGAIN – Retry, max attempts can be changed
\n # STOP_AND_WARN – Notify console of this error
\n # FORCE_START – forcably start the script – THIS WILL LEAD TO EXPLOITS!!!
\n if-exceed-max-time: STOP_AND_WARN
\n max-retry-attempts: 5<\/p>\n
\n # This is the character that denotes a comment line in the batch file.
\n # Any line starting with this character will be ignored during execution.
\n # Default is “#”.
\n comment-char: “#”
\n # Decorator Character
\n # This character is used to identify special decorators in the batch file.
\n # For example, “!sleep 5” uses “!” as the decorator character.
\n # Default is “!”.
\n decorator-char: “!”
\n timing:
\n # Ticking modes:
\n # WORLD – Uses the world’s ticks (synchronous, affected by TPS)
\n # INTERNAL – Uses an internal timer to schedule sleep tasks (Not yet implemented)
\n # CLOCK – Uses the server’s clock to schedule sleep tasks (Not yet implemented)
\n ticking-mode: WORLD<\/p>\n