Cursor rule

1# Gradle Build Standards for Fabric Mod
2 
3## Build Configuration
4- Use Fabric Loom plugin for Minecraft development
5- Set Java compatibility to 21 in build configuration
6- Use Yarn mappings for deobfuscation
7- Include Fabric API as mod dependency
8 
9## Key Configuration Files
10- `build.gradle` - Main build script with dependencies and tasks
11- `gradle.properties` - Version definitions and project properties
12- `settings.gradle` - Repository configuration and plugin management
13- `gradle/wrapper/` - Gradle wrapper for consistent builds
14 
15## Version Management
16```properties
17# gradle.properties example
18minecraft_version=1.21.6
19yarn_mappings=1.21.6+build.1
20loader_version=0.16.14
21fabric_version=0.127.1+1.21.6
22 
23mod_version=1.0.0
24maven_group=com.example
25archives_base_name=my-mod
26```
27 
28## Build Tasks
29- `./gradlew build` - Build the mod JAR
30- `./gradlew runClient` - Run Minecraft client with mod
31- `./gradlew runServer` - Run Minecraft server with mod
32- `./gradlew clean` - Clean build artifacts
33- `./gradlew test` - Run unit tests
34- `./gradlew jar` - Create JAR without dependencies
35 
36## Dependencies
37### Required
38- `minecraft` - Minecraft game dependency
39- `mappings` - Yarn mappings for development
40- `modImplementation fabric-loader` - Fabric mod loader
41- `modImplementation fabric-api` - Fabric API (usually required)
42 
43### Optional
44- `modImplementation` - Runtime dependencies
45- `modCompileOnly` - Compile-time only dependencies
46- `include` - Bundle dependencies in JAR
47 
48## Build Optimization
49- Enable parallel builds: `org.gradle.parallel=true`
50- Allocate sufficient memory: `org.gradle.jvmargs=-Xmx2G`
51- Use build cache for faster rebuilds
52- Configure source compatibility properly
53 
54## Publishing Configuration
55```gradle
56publishing {
57    publications {
58        maven(MavenPublication) {
59            from components.java
60        }
61    }
62    repositories {
63        // Add repositories as needed
64    }
65}
66```
67 
68## Best Practices
69- **Version Control**:
70  - Keep Gradle wrapper in repository
71  - Use properties for version management
72  - Document build requirements
73- **Dependencies**:
74  - Specify exact versions
75  - Minimize bundled dependencies
76  - Check for conflicts
77- **Performance**:
78  - Configure JVM arguments appropriately
79  - Use incremental compilation
80  - Cache dependencies locally
81- **Compatibility**:
82  - Test with minimum and latest versions
83  - Document supported versions
84  - Handle optional dependencies gracefully
85description:
86globs:
87alwaysApply: false
88---