Godot Settings & Save System (Beginner-Friendly) v1.1

🔧 What is this?

This pack provides a complete settings and save system for Godot 4.3+ projects.
It is designed for beginners, game jams, and professional developers who want a production-ready solution with advanced features and clean architecture.

---

✅ Features (v1.2)

🔊 Audio Settings

• Master Volume slider with real-time preview
• Music Volume slider with separate bus control
• SFX Volume slider with independent control
• Mute All toggle - instant global mute without losing volume settings
• Mute When Unfocused - auto-mute when window loses focus

🖥️ Display Settings

• Resolution selector - 1280×720, 1600×900, 1920×1080
• Window Mode selector - Windowed, Fullscreen, Borderless Fullscreen
• VSync toggle with instant application
• Brightness control - smooth transitions from 0.5x to 1.5x

💾 Save System

• Automatic save & load with ConfigFile
• Reset to Defaults button - restore all settings instantly
• Persistent settings across sessions
• Type-safe API with enum-based keys

🎨 Polish & UX

• Smooth brightness transitions with Tween
• Visual feedback on muted sliders
• Auto-centering windows in windowed mode
• Clean, modern interface ready to customize
• WCAG AAA compliant - 7:1+ contrast ratios for optimal readability

---

📦 What's Included (v1.2)

• ✅ Full Godot 4.3+ project ready to use
• ✅ SettingsManager autoload (500+ lines, extensively documented)
• ✅ Complete settings menu scene (pre-built, accessible UI)
• ✅ README.txt - Quick start guide
• ✅ SETUP_GUIDE.txt - Installation instructions
• ✅ API_REFERENCE.txt - Complete function documentation
• ✅ EXTENDING.txt - Step-by-step customization guide
• ✅ TROUBLESHOOTING.txt - Common issues & solutions
• ✅ Example scene - Fully functional demo
• ✅ Code examples - Easy integration snippets
• ✅ Clean and commented GDScript throughout

---

🎯 Who is This For?

• Godot beginners - Learn from clean, documented code
• Game jam developers - Drop in and focus on gameplay
• Professional developers - Production-ready base to customize
• Educators - Teach settings systems with real examples
• Solo devs & studios - Save hours of development time

---

💻 Requirements

• Godot Engine 4.3+ (tested on 4.3 and 4.4)
• Audio Bus Layout with buses named: Master, Music, SFX
• Basic GDScript knowledge (for customization)

---

📜 License

• ✅ Commercial use allowed - Use in free or paid games
• ✅ No attribution required - Credit appreciated but not mandatory
• ✅ Modify freely - Extend and customize as needed
• ✅ Lifetime updates - Bug fixes and improvements included
• ✅ MIT License - Maximum freedom for developers

---

⚠️ Important Notes

• Fullscreen modes work correctly in exported builds. Inside the Godot editor, fullscreen behavior is limited by the engine.
• Audio buses must be named exactly: "Master", "Music", "SFX" for automatic volume control to work.
• Brightness control uses CanvasModulate and affects the entire scene. Adjust as needed for your game's visual style.
• Resolution changes only apply in Windowed mode. Fullscreen uses native display resolution.

---

🚀 Quick Start (5 Minutes)

1. Open project in Godot 4.3+
2. Enable SettingsManager autoload in Project Settings
3. Set up Audio Bus Layout (Master → Music, Master → SFX)
4. Run examples/example_scene.tscn to test
5. Integrate ui/settings_menu.tscn into your game

Full instructions in SETUP_GUIDE.md

---

📚 Documentation

All documentation is included in the documentation/ folder:

• README.txt - Overview and quick start
• SETUP_GUIDE.txt - Step-by-step installation
• API_REFERENCE.txt - Complete API documentation
• EXTENDING.txt - How to add custom settings
• TROUBLESHOOTING.txt - Solutions to common issues