103 lines
3.8 KiB
Markdown
103 lines
3.8 KiB
Markdown
<img align="left" width="100" height="100" src="https://w0n.zip/file/elnvVb">
|
||
|
||
|
||
### XCraftAuth
|
||
Custom yggdrasil authentication
|
||
|
||
#
|
||
|
||
|
||
|
||
|
||
|
||
A powerful **custom session server** plugin for minecraft servers, allowing full **Yggdrasil authentication** support across **1.8-1.16.5 Minecraft versions**! This plugin enables true **online mode authentication** with a self-hosted session server, providing flexibility for your Minecraft network.
|
||
|
||
**THIS PLUGIN ONLY WORKS ON SERVERS THAT RUN UNDER JAVA 8, NEWER VERSIONS OF JAVA WILL BREAK THIS PLUGIN**
|
||
|
||
**🌟 No need for AuthMe!** This plugin completely replaces AuthMe by handling authentication through a custom session server.
|
||
|
||
**🎨 Built-in skin & cape support!** Players can edit their skins and capes without needing Mojang's servers.
|
||
|
||
---
|
||
|
||
## ✨ Features
|
||
|
||
✅ **Supports all modern Minecraft versions** – From 1.8 to the 1.16.5 release.
|
||
✅ **Compatible with all Bukkit/Spigot-based server software**, including:
|
||
- **CraftBukkit**
|
||
- **Spigot**
|
||
- **Paper**
|
||
- **CatServer** (Forge + Bukkit)
|
||
- **Magma** (Forge + Bukkit)
|
||
- **Mohist** (Forge + Bukkit)
|
||
|
||
✅ **Compatible with Bungeecord-based server software**, including:
|
||
- **Bungeecord**
|
||
- **Waterfall**
|
||
|
||
✅ **Full Yggdrasil authentication** – Works with your custom authentication system.
|
||
✅ **Self-hosted session server** – No need for Mojang's authentication services.
|
||
✅ **Seamless integration** – Works as a drop-in replacement for online mode.
|
||
✅ **Replaces AuthMe** – No need for password-based authentication plugins.
|
||
✅ **Custom skin & cape support** – Change your skin and cape at any time!
|
||
✅ **Customizable** – Modify authentication endpoints to fit your needs.
|
||
|
||
---
|
||
|
||
## 📥 Installation
|
||
|
||
1. **Download the latest release** from [Jenkins](https://jenkins.awain.net/job/XCraftAuth/lastSuccessfulBuild/).
|
||
2. **Place the JAR file** in your `plugins` folder.
|
||
3. **Restart your server** to generate the configuration file.
|
||
4. **Configure your public domain and public port (for reverse proxy setup)** in the config file (`config.yml`).
|
||
5. **Restart your server** to apply changes.
|
||
|
||
---
|
||
|
||
## 🎨 Skin & Cape Editing
|
||
|
||
If you use this plugin, **players can change their skins and capes** freely! The skin system is independent of Mojang’s servers and fully integrated with the custom session server. The only thing you need is XCraft launcher
|
||
|
||
---
|
||
|
||
## ⚙️ Configuration
|
||
|
||
Edit `plugins/XCraftAuth/config.yml`:
|
||
|
||
```yaml
|
||
public_domain: "localhost" # Should be the same as the domain of your minecraft server
|
||
public_port: 8999 # Reverse proxy port (leave same if there's no reverse proxy)
|
||
internal_port: 8999 # Session server port
|
||
use_https: false # Set true if you're using reverse proxy setup
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 Usage
|
||
|
||
Once installed and configured, your server will authenticate players using your **custom session server**, just like Mojang’s online mode. Players must authenticate via your system before joining.
|
||
|
||
---
|
||
|
||
## ❓ FAQ
|
||
|
||
**Q: Can this replace Mojang's authentication system?**
|
||
A: Yes! This plugin enables **custom online mode authentication**, independent of Mojang’s servers.
|
||
|
||
**Q: Does this work with cracked clients?**
|
||
A: Yes, but **only** when using the **XCraft launcher**, which integrates with the custom session system.
|
||
|
||
**Q: Can players edit their skins and capes?**
|
||
A: Yes! With this plugin, players can change their skins and capes without Mojang’s servers.
|
||
|
||
**Q: Can this replace AuthMe?**
|
||
A: Yes! Since this plugin uses a session server for authentication, you **do not need AuthMe**.
|
||
|
||
---
|
||
|
||
## 📜 License
|
||
|
||
This project is **open-source** and licensed under the **MIT License**.
|
||
|
||
|