Skip to content

AutoCommands [ACMD]

Jump to bottom
Adrien edited this page Jun 26, 2024 · 25 revisions

Overview

AutoCommands is a Spigot plugin who allow you to create and automate commands for your Minecraft servers.

Including :

  • Fully custom Message
  • Delay Between each commands
  • Delay before start
  • How many times the command must be executed
  • Scheduled start-up
  • Placeholders

Spigot page : https://www.spigotmc.org/resources/autocommands-acmd.100090/

Installation

You need to setup this plugin like any other Spigot plugin's :

  1. Download the last and compatible version for your server.
  2. Drop the .jar into the plugins folder
  3. Restart the server (avoid /reload)
  4. Configure and enjoy !

To prevent operators from seeing all the commands executed in the console it is recommended to set broadcast-console-to-ops=false in your server.properties.

Commands

Commands to use in-game:

  • Create a new ACMD : /acmd new <name> <period> <delay> <number of executions> <command>
    • name: The name of the command, this name will not have any impact, you can even have two commands with the same name.
    • period(in ticks => 20ticks = 1s), the delay between each execution
    • delay (in ticks => 20ticks = 1s), the delay between the activation of the ACMD and the first execution. The activation can be manually, auto(DailyExecutionTime), or if already enable when server start.
    • number of executions : how many cycles do the server have to do before the ACMD goes back to disable
    • command : The command without /, you can use colors codes such as &a. You can add more later.

By default ACMD are disable to enable it use /acmd enable <id>

You can use the editor (GUI) for greater simplicity

  • Edit the ACMD : /acmd edit <id> ...
    • ..addCommand <command> : add a new command in the list.
    • ..removeCommand <ID> : remove a command in the list.
    • ..setDailyExecutionTime <hour> : set a clock that will automatically activate the ACMD. <hour> format : hhHmm eg: 18H42 (6PM42)

Only 24h format is currently supported. See : https://www.wikihow.com/Convert-from-24-Hour-to-12-Hour-Time#Changing-12-Hour-Time-to-24-Hour-Time

  • /acmd run <id> : Launch the ACMD without wait the daily execution time.
  • /acmd stop <id> : Stop a current ACMD.
  • /acmd force <id> : Run the ACMD once time without checking if enable, disable, or any other conditions.
  • /acmd delete <id> : Delete a ACMD.
  • /acmd enable <id> : Allow the ACMD to be run.
  • /acmd disable <id> : Deny the ACMD to be run.
  • /acmd list (page) : List of all ACMD load.
  • /acmd info <id> : Get the information about one ACMD.
  • /acmdtime : Get the current time of the server. Usefull for debuging/test the daily execution. (since 1.5.9)

GUI

  • /acmdeditor: Open the main menu of the GUI, here you can choose a command, click on it and modify it.

  • /acmd edit <id>: Open the editor menu for the claimed acmd.

The editor allow you to modify the acmd attributs:

  • Activation : clickable in the GUI
  • running : clickable in the GUI
  • Name : Type in the chat after clicking in the GUI
  • Period: Type in the chat after clicking in the GUI
  • Delay: Type in the chat after clicking in the GUI
  • repetition: Type in the chat after clicking in the GUI
  • commands: Type in the chat after clicking in the GUI
    • you will only be able to add commands in the GUI.
    • To delete a command please use /acmd edit ..removeCommand <ID> : remove a command in the list.
  • message : Type in the chat after clicking in the GUI
  • Daily scheduler : Type in the chat after clicking in the GUI

*You can also create new ACMD with the green button in the bottom of the main menu. *You can delete an acmd via its menu.

Permissions

  • acmd.*: Give all permissions

  • acmd.reload: Allow to reload the plugin config, lang and commands files.

  • acmd.admin : Allow to create and manage ACMD

Config

All config files examples can be found here. (Please watch the date of the commit and ask a dev on discord if isnt up to date)

Examples can be found in commands default files. If you have any questions about ask help on Discord.

PAPI

ACMD support PAPI placeholder's in command.

See https://wiki.placeholderapi.com for more info.

In this example below, the server repeatedly say the result of 5 x 2.

acmd2:
  active: true
  TaskParameters:
    name: myNewAcmd
    cycle: 0
    delay: 10
    repetition: 4
    running: false
    commands:
   - 'say %math_5*2% ' # <-- Here is the use of placeholders
    message: ''
  DailySchedulerParameters:
    time: ''

If you need help, find an error or have a suggestion, do not hesitate to join our Discord : https://discord.gg/HF8brDSg5V

Clone this wiki locally