Log Sifter

Log Sifter – Filter Out Annoying but Harmless Logs

Ⅰ. Introduction

Log Sifter is a mod designed specifically for Minecraft NeoForge servers and clients (internal codename: Arona-02) , which filters and blocks redundant log information generated in the game. This module is based on the NeoForge platform and can help users reduce noise in log files by customizing configuration rules, making important information more prominent and visible.

II. Main Features

• Log Filtering: Define rules through configuration files to block specific log outputs
• Regular Expression Support: Support precise log content matching using regular expressions
• Dynamic Configuration: Support loading and applying filtering rules at runtime
• Lightweight Design: Does not modify core game functions, focusing only on log management

III. Installation Guide

3-1：Prerequisites

• Installed supported Minecraft version (1.21.1)
• Installed corresponding NeoForge version (21.1.200 or higher)

3-2：Installation Steps

1. Download the latest version from the project’s Release page
2. Place the mod file in the client (or server) mods folder
3. Start the game, and the mod will automatically generate the default configuration file in the config directory
4. Edit the configuration file as needed
5. Restart the server to apply changes
6. Enjoy the clean console and logs brought by Log Sifter

IⅤ. Building from Source Code

If you want to build the plugin from source code, you need Java Development Kit (JDK) 21 or higher.

4-1：Build Steps

1. Clone the repository: git clone https://github.com/MC-Nirvana/log-sifter.git
2. Enter the repository directory: cd log-sifter
3. Execute the build command: ./gradlew build
4. Find the generated JAR file in the build/libs/ directory

4-2：Development Environment Setup

• Recommended to use IntelliJ IDEA for development
• After importing the project, ensure Gradle dependencies download correctly

V. Contribution and Support

Welcome to submit bug reports and feature suggestions through GitHub Issues

5-1：Contribution Methods

• Submit code improvements and new feature implementations
• Improve documentation and translations
• Report bugs and security issues
• Participate in discussions and provide usage feedback

5-2：Best Practices for Submitting Pull Requests

1. Fork the project and create a feature branch
2. Write clear commit messages
3. Ensure code complies with project coding standards
4. Add corresponding test cases
5. Keep Pull Requests focused on a single feature or fix

5-3：Developer Resources

• The project follows standard Git workflow
• Please ensure code passes all tests before submitting a Pull Request
• Maintain consistent code style, refer to existing code structure

VI. License

This project uses the MIT license open source license

VII. Support and Feedback

If you like this project, please consider:

• Giving the project a Star ⭐
• Sharing this project on social media
• Participating in project discussions and providing valuable feedback

VIII. Sponsorship Support

If you wish to support the continued development and maintenance of this project, you can sponsor through the following methods:

• ifdian – Sponsor through ifdian (suitable for mainland China users)
• PayPal – Sponsor through PayPal (suitable for overseas users)

Your sponsorship will be used for:

• Maintaining project infrastructure
• Buying french fries for the author at the dock 🙂

IX. Official Community

• QQ
• Discord