Tanuki.Atlyss

Tanuki.Atlyss is a plugin framework for .NET based on BepInEx for the game Atlyss.

It offers simple plugin localization, command support, events, and much more.

Features

Commands

Commands for each plugin are configured in JSON files.
BepInEx/config/{Plugin assembly name}/default.command.properties

Each command can have multiple names (aliases), the first of which will be the main name of the command.
All names must be in lowercase. If a command name is already in use, it will be automatically removed.
The active command file is automatically cleared and supplemented with commands that exist but have not yet been added.

Commands support arguments that are passed to them as an array of strings.

Example
/example 123 "argument with spaces" 456 'argument with other quotes'
The command will receive the following array:

["123", "argument with spaces", "456", "argument with other quotes"]

If there are no arguments, an empty array will be passed.

Basic bootstrap commands:

• /help [plugin names separated by spaces] - Display a list of plugin commands.
• /reload [plugin names separated by spaces] - Reload the specified plugins.

Translation

Plugin translation using simple text documents, support for different languages.
BepInEx/config/{Plugin assembly name}/default.translation.properties - Default translation file.
BepInEx/config/{Plugin assembly name}/russian.translation.properties - Russian translation file.

Commands are translated in a similar way. For commands, json files with aliases, help, and syntax are used.
BepInEx/config/{Plugin assembly name}/default.command.properties - Default command file.
BepInEx/config/{Plugin assembly name}/russian.command.properties - Russian command file.

To change the language of all plugins, you need to replace it in the bootstrap configuration.
BepInEx/config/9c00d52e-10b8-413f-9ee4-bfde81762442.cfg
The specified language will be used in all plugins where it is available, otherwise the first one encountered will be used.
You should use the full names of languages and only lowercase letters. For example: russian, english, spanish.

Other

Events, patches, fields, and other elements have been moved to the Tanuki.Atlyss.Game project.

Getting Started

Quick start

1. Install BepInEx. It is recommended to use the preconfigured package.
2. Install the Tanuki.Atlyss files.

This framework is available on Thunderstore.

Anything else?

Contacts