AdvancedCommands - Asmodeus1354/VastPlugins GitHub Wiki

Description

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.


Configuration

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.

Example

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

Installation

To successfully install the AdvancedCommands plugin, follow these steps:

Step 1: Download the Plugin

  • Obtain the latest version of the AdvancedCommands plugin .zip file from the releases page.

Step 2: Extract the AdvancedCommands plugin:

Step 3: Place the File

  • Move the downloaded .jar file into your server's plugins folder.
    • The path typically looks like this: /container/plugins/

Step 4: Restart the Server

  • 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.

Step 5: Verify Installation

  • Check if your server loaded the plugin. Run in your server console: pl or plugins and check if AdvancedCommands is green.

Command Documentation

/ac runlater

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.

/ac show <player>

Displays all RunLater commands queued for a specific player.

/ac delete <player> <line>

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).

/ac edit <player> <line>

Edits a specific RunLater command for the player.

  • Modifies the command at the specified line.

FAQ

If you encounter any issues, join our discord and open a ticket here.

⚠️ **GitHub.com Fallback** ⚠️