Ecofren is an online sustainability-driven game that bridges real-world eco-friendly actions with an immersive virtual experience. The project is organized into two main components:
- webapp: A Next.js application providing the web interface for user interactions, dashboards, and integration with various backend services.
- game: A Godot project that delivers the interactive in-game experience, where players explore and impact a dynamic world through their eco-actions.
Ecofren/
├── webapp/ # Next.js web application
└── game/ # Godot game project
- Node.js (v14.x or later) and npm/yarn for the webapp
- Godot Engine (4.x) for the game
- Git for version control
-
Navigate to the
webappdirectory:cd webapp -
Install dependencies:
npm install
or if you prefer yarn:
yarn install
-
Start the development server:
npm run dev
or
yarn dev
The web interface will be available at http://localhost:3000.
-
Open the project in Godot:
- Launch the Godot Engine.
- In the project manager, click "Import" and select the
project.godotfile located in thegamedirectory.
-
Run the game:
- Open the main scene (e.g.,
Main.tscn) from the Godot editor. - Click the "Play" button to start the game.
- Open the main scene (e.g.,
- Webapp: All development related to the Next.js web interface (pages, components, API integration, styling) should be done in the
webappfolder. - Game: All game development (scenes, scripts, assets) is maintained in the
gamefolder using the Godot Engine.
Contributions to Ecofren are welcome! To contribute:
-
Fork the repository and create your branch:
git checkout -b feature/your-feature
-
Commit your changes with clear, descriptive messages:
git commit -am "Add feature X" -
Push your branch:
git push origin feature/your-feature
-
Create a Pull Request detailing your changes.
This project is licensed under the MIT License. See the LICENSE file for details.