wilsontulus / adonis Goto Github PK

 

Adonis is a community-maintained server moderation and management system created for use on the Roblox platform.

📢 New to Adonis? Take a look at our official quick start video or read the unofficial setup guide.

If you get stuck, feel free to ask for assistance on our Discord server.

1. Take a copy of the Adonis loader model from the Roblox Library.
2. Insert the model into Studio using the Toolbox, and place it under ServerScriptService. (Do not leave it in the Workspace!)

1. Download the rbxm file snapshot from the latest release.
2. Import the model file into Studio.

ℹ️ Note: By default, snapshots included in releases have DebugMode enabled.

1. Download the repository to your computer's file system.
2. Install and use a plugin like Rojo to compile Adonis into a rbxmx file. If using Rojo, you can run rojo build /path/to/adonis -o Adonis.rbxmx to build an rbxmx.
3. Import the compiled model file into Studio.

🔐 Warning: By default, loaders compiled from the repository have DebugMode enabled.

⚠️ Method 3 compiles the bleeding edge version of Adonis, which may be not fully tested and is highly unstable.

Once you've inserted the Adonis loader into your game, open Adonis_Loader > Config > Settings, and change settings.DataStoreKey to something absolutely random (eg. "2fgi02e)^Q"). This is for security as it prevents serverside tampering with Adonis's datastores.

You may then edit the Settings module to configure Adonis to suit your game. Instructions and elaboration are provided within the Settings module.

The DebugModule feature enables a number of debug features, including but not limited to:

1. Not protecting the Adonis model (such as parenting it to nil)
2. Exposes a debugging API
3. Enables debugging commands for Creators

The Adonis loader provides a DebugMode option which will load a local copy of the MainModule rather than fetching the latest version. This could be useful if you are a contributor working on the MainModule. Debug mode expects the MainModule to share the same parent with the loader model (e.g. both should be in ServerScriptService). By default, snapshots provided in releases have DebugMode enabled.

1. Open Adonis_Loader > Loader > Loader
2. Change DebugMode at the end of the data table to the desired value (e.g. DebugMode = false)

• Official Adonis Loader: https://www.roblox.com/library/7510622625/Adonis-Admin-Loader-Epix-Incorporated
• Official MainModule: https://www.roblox.com/library/7510592873/Adonis-MainModule
• Nightly MainModule: https://www.roblox.com/library/8612978896/Nightlies-Adonis-MainModule

• 📄 Documentation: https://github.com/Epix-Incorporated/Adonis/wiki
• 📘 User Manual: https://github.com/Epix-Incorporated/Adonis/wiki/User-Manual-&-Feature-Showcase
• 📜 Contributing Guide: https://github.com/Epix-Incorporated/Adonis/blob/master/CONTRIBUTING.md

• Discord Server: https://discord.gg/H5RvTP3 or https://dvr.cx/discord
• Roblox Group: https://www.roblox.com/groups/886423

• Plugins Repository: https://github.com/Epix-Incorporated/Adonis-Plugins
• Donor Perks Pass: https://www.roblox.com/game-pass/1348327

The purpose of this repository is to allow others to contribute and make improvements to Adonis. Even if you've never contributed to GitHub before, we would appreciate any contributions that you can provide.

Read the contributing guide to get a better understanding of our development process and workflow, along with answers to common questions related to contributing to Adonis.

Adonis is available under the terms of the MIT license.