DOCSEARCHbyAlgolia
Submit Docs

Triton Documentation

website·Indexed 32 days ago

https://triton.rexcantor64.com/

Documentation for the Triton translation plugin, featuring guides on bulk translation, dynamic signs, and placeholders. Includes migration paths from v0 through v4, configuration details for config.yml, and information on the TWIN (Triton Web Interface) and the Triton Generator Tool.

Tokens
12.5K
Snippets
56
Records
108
Agent score
58%

What's inside Triton

  1. Overview of the Triton Generator Tool

    The Triton Generator Tool is an open-source web utility that allows users to upload multiple variants of configuration files to automatically generate a translation collection and a version of the original file containing placeholders. This is primarily used for bulk translation of plugin configurations.

  2. Overview of Triton plugin features

    Triton is a Minecraft server plugin designed for international servers. Its primary feature is the ability to send players messages in their own language using a dynamic placeholder that is replaced per player based on a language file. Triton is compatible with any plugin that allows for the customization of messages.

  3. Overview of Triton translation methods

    Triton provides five primary ways to translate messages:

    • Triton Placeholders: For simple static text.
    • Triton Advanced Placeholders: For text containing variables.
    • Triton Patterns: For pattern-based matching.
    • PlaceholderAPI: Integration with the PlaceholderAPI plugin.
    • Triton API: For programmatic translations.

  4. Triton v4 Platform Support

    Triton v4 provides first-class support for Velocity, BungeeCord, and Spigot/Paper. It can translate messages sent by Velocity plugins and includes a bundled MySQL driver, removing the need for manual MySQL driver hacks on Velocity.

  5. Understand breaking changes when migrating Triton v0 to v1

    v0-to-v1

    When upgrading from Triton v0 (MultiLanguagePlugin) to v1, be aware of the following major changes:

    • Language Storage: The languages folder is replaced by a single languages.json file.
    • Configuration: The config.yml file has been modified and requires reconfiguration.
    • SQL Support: SQL support is removed; player language preferences will be reset if SQL was used.
    • Dependencies: ProtocolLib is now a required dependency and must be installed on all Spigot servers.

  6. Understand Triton translation basics and storage

    A translation in Triton is a single message (either text or a sign group) that can be sent in multiple languages. Translations must be organized into 'collections' to allow for bulk settings and better organization.

    Storage depends on the configuration:

    • Local storage: Translations are stored in the translations folder.
    • Database storage: Translations are stored in the translations table.

  7. Install Triton on a server without internet access

    Triton may need to download additional dependencies during its first start. If the server lacks an internet connection or the distribution server is offline, the startup may fail. To resolve this, download the dependency zip file provided for the specific release from the GitHub releases page and provide it to the server.

  8. Use variables in translations

    To insert dynamic values into a translation (e.g., player names), use placeholders like %1, %2, %3, etc. These are replaced by values passed through the Triton Placeholder's arg tag.

    Example: %1 has killed %2. %1 is awesome!

  9. Migrate Triton from v2 to v3

    v2-to-v3
    Upgrading from Triton v2 to v3 involves several breaking changes and configuration updates. Before starting the migration, backup the Triton folder on all servers to prevent data loss.

  11. Migrate Triton from v3 to v4

    v3-to-v4
    Updating to Triton v4 requires manual intervention. Before proceeding, backup the Triton folder on all servers and backup the MySQL database if applicable. Update Triton on all servers and the proxy simultaneously, as bridge messages have changed between v3 and v4.

  12. Use community-generated translation collections

    The community maintains a repository of pre-generated collections for various plugins. These can be found at the triton-translation-collection GitHub repository. Users should follow the README instructions in that repository to add these collections to their server.