RandomTopic is a Minecraft Java Plugin that lets you/your players run a command to announce per-determined "topics" from a list to liven your chat and get players chatting. An example is shown below:
To use RandomTopic on your server, you will need:
To set up and use RandomTopic, first download the plugin. To do so, you can:
Once you've downloaded the plugin, simply put the plugin in your plugins folder. This is usually
under
/plugins
Restart your server to enable the plugin.
You will probably want to change the configuration file to add topics that your server is more interested in. This is explained more within the Configuration Section
To configure topics, messages and more, you will need to do this in the configuration files. There
are two
main configuration files within the plugin; config.yml and lang.yml
config.yml is where most of the plugins configuration, such as topics, messages,
cooldown and
more, are configured.
The lang.yml file is for those who want to change most of the plugins messages to either
match a
different language or just to change what is said when commands are executed.
If you want the plugin to use a different language for the messages, we have some premade configs on our Codeberg Repository which you can simply copy into the existing file.
/RandomTopic/languagesIf you do not find your preffered language, you can simply edit the lang.yml file
yourself.
The configuration files for RandomTopic are stored at /plugins/RandomTopic/.
The configuration is pretty self-explanatory. You can edit the files and then save them. Once you've
configured them to your liking, run the command /randomtopic-reload in game or through
console
to reload the config and language files.
For reference, the default configuration file is:
# RandomTopic Plugin Config
# Made by Ray_y
# Need help? Visit the Support Discord at: https://discord.gg/EshbnCjhfc
commandprefix: "§a[§fRandomTopic§a]"
# ^^ This changes the prefix of the command prefix.
randomTopicList:
- Random Topic 1!
- Random Topic 2!
- Random Topic 3!
- Random Topic 4!
# This is your customizable topic list! You can edit the list here or add or remove more elements which will be randomly selected
# when the randomtopic command is run! (/randomtopic)
check-for-updates-on-join: true
# ^^ Send a message to any player the joins with the permission "randomtopic.updatecheck" if there is an update
# that is available to download.
# -- **Messages** --
nopermsmsg: "§cYou do not have permission to use this command."
# ^^ Message that is sent when a user does not have permission to use a command in the plugin
cooldown-message: "§cThis command has been executed by another player already recently! Please wait %time-remaining% seconds."
# ^^ Message that is sent when a player executes the /randomtopic command but the command is on cooldown.
# Only works if global-cooldown is "enabled"
# -- **Other** --
global-cooldown: enabled
# ^^ Choice of whether a global cooldown is enabled on the /randomtopic command. This cooldown affects **ALL PLAYERS** not just the sender.
global-cooldown-time: 10
# ^^ If global-cooldown is enabled, this option will be how long the global command cooldown is. This is measured in seconds.
RandomTopic has many commands and permissions for those commands. The following list will show you all commands and permissions that are a part of the plugin.
Commands
randomtopic:
- description: Announce a random topic from the configured list!
- aliases: topic, rtopic, randomtpc
randomtopic-reload:
- description: Reload the randomtopic configuration file.
randomtopic-checkforupdates:
- description: Check for any available updates
randomtopic-list:
- description: Sends all of the configured topics in config.
randomtopic.usecommand:
- description: Allows the player to use the /randomtopic command!
randomtopic.reload:
- description: Allows player to reload the randomtopic configuration file.
randomtopic.updatecheck:
- description: Allows the player to check for any plugin updates.
randomtopic.list:
- description: Allows the player to view the list of topics set using /randomtopic-list
A mostly complete list of the features that come with RandomTopic:
Global Cooldown/randomtopic command.lang.yml file.If you are confused on how to use the plugin, found a bug, or want to get in contact, please select the most relevent option from the options below.
Issues:lang.yml files or new
code,
please submit a pull request on our Codeberg repository.