Lilia - Advanced Roleplay Framework for Garry's Mod
A modern, modular, and highly extensible roleplay framework designed for stability and immersion.
Build your dream roleplay server with powerful built-in systems and seamless addon compatibility.

Lilia Framework

---

🌟 Key Features

Built-in Core Systems

• 📦 Advanced Inventory System - Grid-based inventory with weight limits, item stacking, and hot-loading modules
• 👥 Team & Faction Management - Comprehensive faction system with whitelist support and admin controls
• 🎭 Character Attributes - Dynamic character attribute system with management tools
• 🚪 Door Ownership - Sophisticated door access control with ownership and tenant permissions
• 💬 Enhanced Chat System - Configurable chat with colored text, command parsing, and staff channels
• 🎯 Recognition System - Immersive character recognition where players must learn each other's names
• 📊 Dynamic Scoreboard - Immersive scoreboard showing recognized players and faction information

Administration & Security

• 🛡️ Built-in Admin Menu - Complete administration suite with logging, tickets, and teleport tools
• 🔒 Anti-Cheat Protection - Comprehensive anti-exploit and anti-cheat systems
• 👮 Staff Management - Advanced permission system with granular privilege controls
• 📋 Player Management - Character listing, player information, and administrative tools

Developer-Friendly

• 🔧 Modular Architecture - Hot-loadable modules for easy customization and updates
• 📚 Extensive Documentation - Complete API reference and development guides
• 🔌 DarkRP Addon Support - Out-of-the-box compatibility with DarkRP addons and GMODStore content
• ⚡ Performance Optimized - Built for stability and high player counts

---

🚀 Quick Start

Follow our step-by-step installation tutorial to set up Lilia on your server.

Important: Lilia is a framework that runs beneath a roleplay schema. After installing Lilia, you must also install a schema and start your server using that schema's gamemode (e.g., +gamemode skeleton).

📚 Documentation

Explore the complete documentation for in-depth guides on configuring and extending Lilia:
https://liliaframework.github.io

What's Included:

• Installation Tutorial - Step-by-step setup guide
• API Reference - Complete function and library documentation
• Module Development - Guide to creating custom modules
• Configuration - Detailed configuration options
• Compatibility Guide - Addon integration information

📦 Workshop Content

Subscribe to our essential Steam Workshop collection for the assets you'll need to run Lilia optimally.

Pro Tip: The workshop release contains the entire gamemode, so you can replace your local lilia folder with it for easier updates and automatic content delivery.

💬 Community & Support

Connect with other server owners, get real-time help, and share your creations:
https://discord.gg/esCRH5ckbQ

Get Help:

• Discord Community - Real-time support and discussions
• Documentation - Comprehensive guides and API reference
• GitHub Issues - Bug reports and feature requests

🔧 Addon Compatibility

Lilia includes extensive compatibility layers for popular Garry's Mod addons, ensuring seamless integration with your existing addon collection:

🎯 DarkRP Addon Support

• Out-of-the-box compatibility with most DarkRP addons
• Automatic shim functions - isEmpty, findEmptyPos, formatMoney, createEntity, createCategory
• No modification required - Your existing DarkRP addons work immediately
• Community & GMODStore addons supported without changes

🛠️ Other Supported Addons

• Administration Suites - SAM, ServerGuard, CAMI integration
• Vehicle Frameworks - LVS, Simfphys compatibility
• Outfit Systems - PAC3 integration with permission controls
• Weapon Frameworks - ARCCW optimization for roleplay
• Utility Addons - Advanced Duplicator, Sit Anywhere, and more

Note: ULX is not recommended due to outdated CAMI library. Use Lilia's built-in admin menu or SAM instead.

💡 Contributing

We welcome contributions to both code and documentation! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes and test thoroughly
4. Submit a pull request with a clear description

What We're Looking For:

• Bug fixes and performance improvements
• New modules and features
• Documentation improvements
• Compatibility enhancements

Please review our Code of Conduct before contributing.

🎓 Learning & Development

For Developers:

• Intermediate Lua Knowledge - Familiarity with Garry's Mod Lua is recommended
• Modular Development - Learn to create custom modules and schemas
• API Documentation - Complete reference for all Lilia functions and libraries

For Server Owners:

• Easy Configuration - Intuitive setup with comprehensive documentation
• Schema Compatibility - Works with any roleplay schema built on Lilia
• Regular Updates - Active development with frequent improvements

Official Resources:

• Main Repository - LiliaFramework/Lilia
• Official Modules - LiliaFramework/Modules
• Documentation - liliaframework.github.io

---

📄 License

All Lilia content is open source under the GNU General Public License v3.0. See the License file for details.

• ✅ Study and modify for your own server
• ✅ Educational use is encouraged
• ❌ Commercial resale is discouraged
• ✅ Contribute back to the community

---

Ready to build your dream roleplay server?
Get started with Lilia today!