Moon Habitat Simulator
Overview
The Moon Habitat Simulator is an interactive JavaFX application designed to visualize and manage conceptual lunar habitats. The goal of this project is to provide a user-friendly interface for simulating the construction, configuration, and occupancy of habitats on the Moon, helping users understand how various parameters affect life-support and space utilization.
This project combines 3D visualization, interactive controls, and parameter management to create a semi-realistic environment for educational, research, or planning purposes.
⸻
Key Features 1. 3D Simulation Area • The central part of the application is reserved for a simulated lunar habitat, which will later support 3D modules and structures. • Users can visualize habitat components and see how changes affect the environment.
-
Sidebar Menu • A retractable menu allows users to add or remove habitat modules. • The menu can be toggled for more screen space, similar to modern UI applications.
-
Settings Panel • Provides input fields for habitat parameters: • Type of stay (Research, Work, Family) • Number of people • Duration of stay • Optional personal data: weight, height, gender • Changes are applied through the Apply button, updating the status bar at the bottom of the window. • Modal design ensures focus on settings while they are being edited.
-
Bottom Status Bar • Displays currently applied settings in real-time. • Provides a quick overview of occupancy, stay type, and optional personal statistics.
⸻
Purpose
The main purpose of this project is to simulate the management of a lunar habitat while providing: • An interactive interface for adjusting parameters. • Visual feedback via a 3D simulation area. • Structured, modular code that separates concerns for easier development and future expansion.
This project can be used for: • Educational demonstrations of habitat planning in space. • Prototype planning for research on occupancy and resource management. • Learning JavaFX and UI design for complex simulations.
⸻
How to Run 1. Ensure you have Java 21 or later installed. 2. Clone the repository. 3. Use Maven or your preferred IDE to import the project. 4. Run the HabitatUI class to start the application. 5. Use the sidebar to add modules and the settings panel to configure the habitat.
⸻
Future Improvements • Integrate actual 3D modules in the simulation area. • Add real-time calculations of resource usage based on input parameters. • Expand input options for environmental conditions (temperature, oxygen, etc.). • Implement saving and loading of habitat configurations.
⸻
This README provides context, explains functionality, and communicates the purpose and potential of the Moon Habitat Simulator.