Skip to main content

Welcome Contributors

Contributions to cslol-manager are welcome! Whether you’re fixing bugs, improving documentation, or suggesting new features, your help is appreciated.
Maintenance Mode Noticecslol-manager is currently in maintenance mode. Active development has shifted to LTK Manager.We still accept bug fixes and minor improvements, but major new features may be redirected to the new project.

Ways to Contribute

Report Bugs

Found a bug? Help us fix it!
  1. Check existing issues first: Known Issues
  2. Search the issue tracker to avoid duplicates
  3. Create a new issue with:
    • Clear description of the bug
    • Steps to reproduce
    • Expected vs actual behavior
    • Screenshots (if applicable)
    • Log file (found next to cslol-manager.exe)
Always upload your log file when reporting bugs. It contains essential diagnostic information.

Suggest Features

Have an idea for improvement?
  1. Check the issue tracker to see if it’s already suggested
  2. Create a feature request explaining:
    • What problem it solves
    • How it would work
    • Why it would benefit users
Major new features may be considered for LTK Manager instead.

Submit Pull Requests

Ready to contribute code?
  1. Fork the repository
  2. Create a branch for your changes
  3. Make your changes:
    • Follow existing code style
    • Add comments where helpful
    • Test thoroughly
  4. Commit with clear messages
  5. Submit a Pull Request describing:
    • What you changed
    • Why you changed it
    • How to test it

Development Setup

Prerequisites

  • Windows 10 or 11 (64-bit)
  • Visual Studio 2019 or later with C++ support
  • Qt Framework (version used by the project)
  • Git for version control

Building from Source

  1. Clone the repository:
    git clone https://github.com/LeagueToolkit/cslol-manager.git
    cd cslol-manager
    
  2. Open the project in Visual Studio or Qt Creator
  3. Build the solution
  4. Run and test your changes
Detailed build instructions may be available in the repository’s README or documentation.

Code Guidelines

Style

  • Follow the existing code style in the project
  • Use meaningful variable and function names
  • Add comments for complex logic
  • Keep functions focused and concise

Testing

  • Test your changes thoroughly before submitting
  • Verify that existing functionality still works
  • Test with different mod types and configurations
  • Check compatibility with the latest League patch

Commits

  • Write clear, descriptive commit messages
  • One logical change per commit
  • Reference issue numbers when applicable (e.g., “Fix #123”)

CSLOL DLL Policy Compliance

If you’re working with or distributing the DLL, you must comply with the CSLOL DLL Policy.
Key requirements:
  • Re-sign with your own certificate (never redistribute with the original signature)
  • Implement anti-skinhacking controls
  • Publish transparency information
  • Do not modify or tamper with the DLL binary

License

cslol-manager is licensed under GPL-3.0. By contributing, you agree that your contributions will be licensed under the same terms. See the License page for details.

What This Means

  • Your code must be compatible with GPL-3.0
  • You retain copyright of your contributions
  • Your contributions become part of the open-source project
  • Others can use, modify, and distribute your contributions under GPL-3.0

Community Guidelines

Be Respectful

  • Treat all contributors with respect
  • Provide constructive feedback
  • Be open to different perspectives
  • Help others learn and grow

Be Professional

  • Focus on technical merit
  • Avoid personal attacks
  • Keep discussions on-topic
  • Follow the project’s Code of Conduct (if available)

Getting Help

Need help contributing?
  • Issues: Ask questions in GitHub issues
  • Discussions: Use GitHub Discussions for general questions
  • Documentation: Check the project README and docs

Recognition

Contributors are valued members of the League Toolkit community! Your contributions help make modding accessible to everyone.

Contact

For project-related inquiries:
Thank you for contributing to cslol-manager! Developed by the League Toolkit Organization

Build docs developers (and LLMs) love