Drill Down - Enhanced Edition

A factory building game with modern improvements and enhanced features. Build production chains, mine resources, and expand deeper underground.

Original: Dakror/DrillDown

✨ New Features

🚀 Speed Controls

Visual UI buttons for game speed adjustment (1x, 2x, 4x, 10x, 25x) with keyboard shortcuts (P to cycle, O to reset).

🌬️ Air Purifier Balance

Air Purifiers now cover an entire layer - only one needed per depth level instead of multiple units.

🚡 Enhanced Item Elevators

Complete visual overhaul for vertical transport between floors:

• Directional Sprites: White graphics for upward travel, black for downward
• Floor Labels: Input/exit elevators show destination/source floor numbers
• Passthrough Labels: Intermediate floors display both source and target floors with a diagonal dividing line
• Color-Coded Text: Black text on white backgrounds (upward), white text on dark backgrounds (downward)
• Blue Tinting: All elevator structures feature distinctive blue-tinted graphics
• Fixed Bugs: Resolved rotation, placement, direction persistence, and 1-floor elevator labeling issues

🔧 Relief Valve System

• Unique structure that prevents overpressure in fluid systems
• Fluid only flows when input exceeds 99% capacity threshold
• Directional output control with orange-tinted graphics
• Automatically detects connected pipes when threshold is reached

⚙️ Coker Building

• Advanced fuel processing structure for producing Petroleum Coke
• Converts Refined Oil into high-density Petroleum Coke through thermal cracking
• Minimalist flat top-down design aesthetic
• Requires Advanced Fuel Processing technology
• Complete texture implementation with building sprite, UI icon, and dark fuel item graphic

🛠️ Modern Build System

• Gradle 8.3 (Java 21+ compatible)
• Updated dependencies and syntax
• Clean, reproducible builds

📚 Complete Documentation

• Full debug keybinds reference (20+ commands)
• Setup and development guides
• Helper scripts for building and running
• Agent-Focused Texture Guides (crucial for adding new graphics)
  • Quick Start for AI Agents
  • Pre-Commit Verification

🚀 Quick Start

Windows: Double-click RUN_GAME.bat

Other platforms:

gradlew desktop:run

Build from source:

gradlew desktop:dist

See docs/README_SETUP.md for detailed instructions.

📋 Requirements

• Java 11+ (tested with Java 21)
• Gradle 8.3 (included)

🐛 Debug Mode

Run with RUN_GAME.bat or pass debug argument for developer controls:

• G - God mode, P - Cycle speeds, O - Reset speed
• X - Fill structures, F - Fill fluids, D - Debug overlay
• 0-5 - Select liquid type (Water, Oils, Molten Copper) for filling tanks/pipes
• H - Frame step, F1 - Toggle UI

Full debug reference →

📚 Documentation

• Setup Guide
• Development Guide
• Debug Controls
• Build Summary
• Speed Controls Details

✅ Continuous Integration & Automated Builds

GitHub Actions automatically builds and signs your APK on every push to main.

Workflow Config: .github/workflows/ci.yml
View Latest Builds: Actions Tab

Each CI run:

1. ✅ Builds desktop distribution (desktop:dist)
2. ✅ Builds signed release APK (android:assembleFullRelease)
3. ✅ Signs with your official keystore (stored securely in GitHub Secrets)
4. ✅ Uploads APK as downloadable artifact

📱 Install APK Directly from GitHub

No PC needed! Download and install the latest signed APK on any Android device:

1. Trigger a build: Push changes to main (or re-run the workflow)
2. Get the APK:
   • Open Actions → latest successful run
   • Scroll to Artifacts → Download android-release-apk
3. Install:
   • Extract the .zip file (any Files app works)
   • Open the .apk
   • If prompted, allow installs from unknown sources
   • APK installs directly over your existing app—all your data is preserved

💡 Tips

• Artifacts are already signed with your official certificate (no package conflicts!)
• Artifacts expire after 90 days; push again to regenerate
• You can re-run the workflow without pushing: Actions → ⋯ → Re-run jobs

Texture & Graphics Development

⚠️ Adding New Graphics? Start here:

• Agent Quick Start - 2-3 min overview
• Agent Before Commit - Pre-commit checklist
• Complete Implementation Guide
• System Architecture
• Comprehensive Reference

🤝 Contributing

Issues and pull requests welcome!

📄 License

Apache License 2.0 - See LICENSE

🔗 Links

Tech: LibGDX 1.9.9 | Java | Gradle 8.3
Original: https://github.com/Dakror/DrillDown
Framework: LibGDX

Clouds are Beautiful!