AdvancedCommands - Asmodeus1354/VastPlugins GitHub Wiki
AdvancedCommands is a versatile and powerful Minecraft plugin designed to streamline server management and enhance gameplay with customizable command execution. Whether you're an administrator or a player, this plugin offers unparalleled flexibility and control.
The configuration is fully automated and dynamically generated. No manual setup is required, as all actions can be managed directly through in-game commands. This makes it easy to add, edit, or remove scheduled commands and messages without needing to edit configuration files manually.
With just a few commands, you can effortlessly customize and fine-tune the plugin to suit your server's needs. All changes are reflected instantly, ensuring a seamless experience for administrators.
players:
<player-uuid>:
'<action-id>':
command: <command-to-execute>
delay: <delay-in-seconds>
amount: <number-of-executions>
executeOnce: <true|false>
permission: [<required-permission-nodes>]
message: <custom-message>
world: [<applicable-worlds>]
log: <true|false>
Field Descriptions
<player-uuid>: The UUID of the player for whom the actions are defined.
<action-id>: A unique identifier for the action (typically a numeric index).
command: The command to execute (e.g., say Welcome to the server!).
delay: The delay before executing the command, in seconds.
amount: The number of times the command should execute.
executeOnce:
true: The command executes only once per player session.
false: The command executes repeatedly based on the delay and amount specified.
permission: A list of permissions required to trigger the command (empty if none required).
message: A custom message sent to the player (optional).
world: A list of worlds where the command applies (empty for all worlds).
log:
true: Logs the action for debugging or record-keeping.
false: No logging for this action.
players:
123e4567-e89b-12d3-a456-426614174000:
'0':
command: give %player% diamond 1
delay: 10
amount: 3
executeOnce: true
permission: [advancedcommands.use]
message: Here’s a gift for you, %player%!
world: [world_nether]
log: true
To successfully install the AdvancedCommands plugin, follow these steps:
- Obtain the latest version of the AdvancedCommands plugin .zip file from the releases page.
- Extract the [AdvancedCommands-X.X.jar] from the downloaded zip file. For guidance on extraction, refer to the following links:
- Move the downloaded .jar file into your server's
plugins
folder.- The path typically looks like this:
/container/plugins/
- The path typically looks like this:
- Restart your Minecraft server to load the new plugin. This can usually be done by using the following command in your server console:
restart
Alternatively, you can stop the server and start it again manually.
- Check if your server loaded the plugin. Run in your server console:
pl
orplugins
and check ifAdvancedCommands
is green.
Executes a command when a player is online with customizable options.
Arguments
-c <command>
The command to execute.
- Must be the last argument.
- Placeholders:
-
%player%
: Replaces with the player's name. -
%world%
: Replaces with the player's current world. -
%coords%
: Replaces with the player's coordinates (<x> <y> <z>
).
-
-p <player | *>
Determines the player(s) for whom the command runs.
-
*
: Targets all players who have ever been online.
-perm "<permission node>"
Runs the command only if the player has the specified permission.
-d <time in seconds>
Delay in seconds before the command executes after the player joins the server.
-a <number>
The number of times the command should run.
-e <true|false>
Defines behavior when using
-a
.
-
true
: Runs once every time the player comes online. -
false
: Runs the command the specified number of times with the-d
delay. Default:false
.
-r <true|false>
Replaces an existing RunLater command for the player if a similar one exists.
- Default:
false
.
-w <world_name>
Runs the command only if the player is in the specified world.
-m <message>
Sends a message to the player.
- Placeholders:
-
%player%
: Replaces with the player's name. -
%world%
: Replaces with the player's current world. -
%coords%
: Replaces with the player's coordinates (<x> <y> <z>
). -
%papi_<placeholder>
: Uses a PlaceholderAPI placeholder.
-
Displays all RunLater commands queued for a specific player.
Deletes RunLater commands.
- If
<line>
is empty, deletes all commands for the player. - If
<line>
is specified, deletes only the command at that line (refer to/ac show
).
Edits a specific RunLater command for the player.
- Modifies the command at the specified line.
If you encounter any issues, join our discord and open a ticket here.