2023-03-18 18:11:57 +01:00
|
|
|
# StarOpenSource CORE (aka. SOSCORE aka. CORE)
|
2023-03-18 16:34:12 +01:00
|
|
|
CORE is a framework that simplifies development for games and applications made in Godot 4.
|
|
|
|
|
2023-03-18 18:11:57 +01:00
|
|
|
# Documentaton
|
|
|
|
[You can access the documentation by clicking this text.](https://git.staropensource.de/StarOpenSource/core/wiki)
|
|
|
|
|
2023-03-18 16:34:12 +01:00
|
|
|
# For whom is it useful?
|
2023-03-18 18:43:40 +01:00
|
|
|
CORE is only useful for new projects. Already existing projects could break because CORE has certain requirements that must be met.
|
2023-03-18 16:34:12 +01:00
|
|
|
|
|
|
|
# Requirements
|
2023-03-18 16:36:07 +01:00
|
|
|
- No autoload singletons are allowed before CORE has initialized
|
2023-03-18 18:45:00 +01:00
|
|
|
- Startup scene must be `res://CORE/background.tscn`
|
2023-03-18 16:34:12 +01:00
|
|
|
- Scene management must be done with smgr (the CORE scene manager)
|
|
|
|
- Logging should be handled using the CORE logger
|
|
|
|
|
|
|
|
# How to install
|
|
|
|
- Clone CORE into your project root using `git clone https://git.staropensource.de/StarOpenSource/core.git CORE`
|
2023-03-18 18:11:57 +01:00
|
|
|
- Remove any autoload singletons
|
2023-03-18 16:34:12 +01:00
|
|
|
- Add three scripts to your autoload:
|
2023-03-18 18:45:00 +01:00
|
|
|
| Name | Path |
|
|
|
|
| ------------ | ---------------------------- |
|
|
|
|
| coreloader | `res://CORE/coreloader.gd` |
|
|
|
|
| Logger | `res://CORE/logger.gd` |
|
|
|
|
| Preprocessor | `res://CORE/preprocessor.gd` |
|
|
|
|
- Select `res://CORE/background.tscn` as your startup scene
|
2023-03-18 18:11:57 +01:00
|
|
|
- [Follow the post-installation guide](https://git.staropensource.de/StarOpenSource/core/wiki/Using-CORE)
|
2023-03-18 16:34:12 +01:00
|
|
|
|
|
|
|
# How to update
|
2023-03-18 18:11:57 +01:00
|
|
|
- Close your project
|
2023-03-18 16:34:12 +01:00
|
|
|
- Pull new changes using `git pull`
|
2023-03-18 18:11:57 +01:00
|
|
|
- Reopen your project
|