Add README.md
This commit is contained in:
127
README.md
Normal file
127
README.md
Normal file
@@ -0,0 +1,127 @@
|
||||
# PyFabricLoader
|
||||
|
||||
A Python mod loader for Minecraft Fabric using Jython, allowing to load and run Python mods.
|
||||
|
||||
## Features
|
||||
|
||||
- Load and run Python mods in Minecraft Fabric
|
||||
- Easy-to-use Python API for mod development
|
||||
- Command system for Python mod management
|
||||
- Configuration management for Python mods
|
||||
- Support for multiple Minecraft versions (1.18.1 - 1.21.10)
|
||||
- Cross-platform compatibility
|
||||
|
||||
## Requirements
|
||||
|
||||
- Minecraft 1.18.1 - 1.21.10
|
||||
- Fabric Loader 0.14.0+
|
||||
- Java 17+
|
||||
- Fabric API
|
||||
|
||||
## Installation
|
||||
|
||||
1. Install Fabric Loader and Fabric API for your Minecraft version
|
||||
2. Download the latest PyFabricLoader JAR file
|
||||
3. Place the JAR file in your Minecraft mods folder
|
||||
4. Launch Minecraft with Fabric
|
||||
|
||||
## Usage
|
||||
|
||||
### Adding Python Mods
|
||||
|
||||
1. Create a `PyFabric` folder in your Minecraft directory
|
||||
2. Place your Python mod files in this folder
|
||||
3. Each mod should have an `__init__.py` file as the entry point
|
||||
|
||||
### Python Mod Structure
|
||||
|
||||
```
|
||||
PyFabric/
|
||||
└── your_mod/
|
||||
├── __init__.py
|
||||
└── other_files.py
|
||||
```
|
||||
|
||||
### Example Python Mod
|
||||
|
||||
```python
|
||||
# __init__.py
|
||||
|
||||
def on_load():
|
||||
print("Your mod has been loaded!")
|
||||
|
||||
def on_unload():
|
||||
print("Your mod has been unloaded!")
|
||||
```
|
||||
|
||||
### Commands
|
||||
|
||||
- `/pyfabric reload` - Reload all Python mods
|
||||
- `/pyfabric list` - List all loaded Python mods
|
||||
- `/pyfabric help` - Show help for PyFabric commands
|
||||
|
||||
## Development
|
||||
|
||||
### Setting Up the Development Environment
|
||||
|
||||
1. Clone the repository
|
||||
2. Open the project in your preferred IDE (IntelliJ IDEA recommended)
|
||||
3. Run `./gradlew setupDecompWorkspace` to set up the workspace
|
||||
4. Run `./gradlew genSources` to generate sources
|
||||
5. Start coding!
|
||||
|
||||
### Building the Project
|
||||
|
||||
```bash
|
||||
./gradlew build
|
||||
```
|
||||
|
||||
The built JAR file will be located in `build/libs/`.
|
||||
|
||||
## API Documentation
|
||||
|
||||
### Python API
|
||||
|
||||
#### Event Handlers
|
||||
|
||||
- `on_load()` - Called when the mod is loaded
|
||||
- `on_unload()` - Called when the mod is unloaded
|
||||
|
||||
#### Minecraft API
|
||||
|
||||
PyFabricLoader provides a Python API for interacting with Minecraft. Check the `PyCommandAPI.java` file for available methods.
|
||||
|
||||
## Configuration
|
||||
|
||||
### Mod Configuration
|
||||
|
||||
Each Python mod can have its own configuration file in the `config/pyfabric/` directory.
|
||||
|
||||
### Global Configuration
|
||||
|
||||
The global configuration file is located at `config/pyfabric/config.json`.
|
||||
|
||||
## License
|
||||
|
||||
MIT License
|
||||
|
||||
## Credits
|
||||
|
||||
- Developed by 银河万通软件开发工作室 工程部 TermiNexus
|
||||
- Website: [https://www.gvsds.com](https://www.gvsds.com)
|
||||
|
||||
## Contributing
|
||||
|
||||
Contributions are welcome! Please feel free to submit a Pull Request.
|
||||
|
||||
## Support
|
||||
|
||||
For support, please visit our website or create an issue on GitHub.
|
||||
|
||||
## Changelog
|
||||
|
||||
### Version 1.0.0
|
||||
- Initial release
|
||||
- Basic Python mod loading functionality
|
||||
- Command system
|
||||
- Configuration management
|
||||
Reference in New Issue
Block a user