TaigaCore

Discord help chat: https://discord.gg/e5QRdBw

TaigaCore is the core library used by most of my plugins. This plugin handles many things, including, but not limited to:

• Player messages
• MySQL, SQLite and MariaDB
• Redis
• Plugin manager with update checker and plugin installer
• Logging
• Many other utilities

TaigaCore supports your language!
TaigaCore reads packets to determine the player's language setting and sends messages to players depending on their language. You can add your own languages and modify existing languages in the /plugins/TaigaCore/lang folder.
Currently supported languages:
English (US) - by bys1
English (UK) - by bys1
Dutch (NL) - by bys1
German (DE) - by bys1
LOLCAT - by bys1
Pirate Speak - by bys1

Automatic update checking and plugin installer
TaigaCore checks for updates every 30 minutes and will notify the console and everyone with the proper permission of new updates when a new version is found. You can also install my plugins in-game or from the console using the simple command /taiga install <plugin> <version>. This will download the plugin from Spigot and place it in the plugins folder, replacing the file specified in the TaigaCore config.
Note: Update checking and plugin installing for the TaigaCore plugin itself is currently not supported.

Installation

To install TaigaCore, follow these steps:

1. Download the version you need and drop it in your server's plugins folder. A plugin compatibility table can be found below.
2. Restart your server.
3. TaigaCore will download and load an API that is required for most things.
4. Configure your plugin. A description of the TaigaCore configuration can be found below.
5. Restart your server to process any changes made to the configuration.
6. You can now start downloading other plugins using the /taiga install command.

Commands

The TaigaCore main command is /taigaplugin and requires the permission taigacore.taigaplugin. Aliases: /taigapl, /taiga. All commands have tab completion.

- /taiga help
Permission: taigacore.taigaplugin.help
Shows a list of commands.

- /taiga plugins
Permission: taigacore.taigaplugin.plugins
Shows a list of my plugins and their current state on your server.

- /taiga check <plugin>
Permission: taigacore.taigaplugin.check
Checks for available updates

- /taiga install <plugin> <version>
Permission: taigacore.taigaplugin.install
Downloads and installs the specified plugin.

- /taiga delete <plugin>
Permission: taigacore.taigaplugin.delete
Deletes the specified plugin from your server.

- /taiga load <plugin>
Permission: taigacore.taigaplugin.load
Loads the specified plugin on your server.

- /taiga unload <plugin>
Permission: taigacore.taigaplugin.unload
Unloads the specified plugin from your server.

- /taiga enable <plugin>
Permission: taigacore.taigaplugin.enable
Enables the specified plugin.

- /taiga disable <plugin>
Permission: taigacore.taigaplugin.disable
Disables the specified plugin.

The second command of TaigaCore is /language, requiring the permission taigacore.language. Aliases: /lang

- /language <locale>
Permission: taigacore.language
Changes your language to the specified locale, if supported. Locales should be in the following format: xx_xx. Examples are en_us, en_uk, lol_us, en_pt and de_at.


Permissions

taigacore.language - Allows you to set your language using /language
taigacore.taigaplugin - Allows you to use /taigaplugin
taigacore.taigaplugin.help
taigacore.taigaplugin.plugins
taigacore.taigaplugin.check
taigacore.taigaplugin.install
taigacore.taigaplugin.delete
taigacore.taigaplugin.load
taigacore.taigaplugin.unload
taigacore.taigaplugin.enable
ttaigacore.taigaplugin.disable
taigacore.taigaplugin.* - Gives you all taigacore.taigaplugin permissions
taigacore.* - Gives you all TaigaCore permissions

Configuration

config.yml:
Logging determines how much TaigaCore will log. INFO will only display warnings, errors and some basic plugin messages. NOTICE will display several information about different things and DEBUG will display all debug messages to help with bug fixing.
The plugin-files are the JAR files in your plugins folder where plugins will be installed. If you change these while having plugins installed, make sure to rename the actual JARs too.

lang/config.yml:
This is the file where all languages are managed. If a player joins, TaigaCore will look up the player's locale in this file as soon as the packet is received. If the locale is found, the specified file will be used for the messages sent to the player. If the locale is not found, the default language will be used instead.

lang/en_us.yml:
The en_us language file. All player messages for this language can be managed here. Placeholders like %time% will automatically be replaced with a value when sent to the player.

COMPATIBILITY


SUPPORT
If you need any help installing and setting up plugins, have suggestions to improve plugins or found a bug in a plugin, feel free to contact me! I will do my best to help you as fast as possible. I usually reply within a few hours although there can and will always be some exceptions. My timezone is CET (GMT+1), so if you live somewhere else than in Europe and you're wondering why I do not reply within two minutes, this is probably why.

If you have a general question about a plugin, or have suggestions or ideas to improve a plugin, post it in the Discussion section on Spigot or in the plugin channel in Discord.

If you need help with installing and setting up a plugin, or have any issues with a plugin, contact me in a private conversation on Spigot or post it in the plugin channel in Discord.

If you have a bug report, make sure to follow the steps listed below:

1. Go to the plugin config and set logging to DEBUG.
2. Restart your server (Don't reload!) and try to reproduce the error, for example by using the command that created the error.
3. If the error occurs again, include the following in your message:
   • A FULL console log. Use [CODE] [/CODE] tags on Spigot or paste it in http://paste.md-5.net/. Note that in console errors the newlines in the error may be removed. Please re-add them to keep the error readable for me.
   • The config file(s) of the plugin(s). Use [CODE=YAML] [/CODE] tags on Spigot or add them as a file in Discord, or paste them in http://paste.md-5.net/.
   • Optional, but strongly recommended: A list of all installed plugins on your server and their versions.

ABOUT THE AUTHOR
Hello! I am Björn and my goal is to create good-quality plugins with many features and efficient RAM-usage. I aim to provide good support (see above) and take all suggestions and bug reports serious. Feel free to contact me with any questions you have!

TERMS OF SERVICE