CORE/docs/troubleshooting.md
JeremyStarTM 83ea84b9ab Documentation/website release and more
This commit added:
- A website and documentation (two in one) containing a install guide and code references
- Character counting script (count_characters.sh)
- Godot development project support (making a temporary godot project)
- Makefile
2023-07-09 00:16:15 +02:00

4.2 KiB

hide
navigation

Troubleshooting CORE

Warning: This is a very messy document. Use the table of contents to get to your specified error. If you can't find your problem here, create a issue.

Invalid argument issues

(wmgr) [ERROR] Invalid window mode "<PLACEHOLDER>".

wmgr's set_mode() function recieved a invalid window mode. Only possible options are "WINDOWED", "MINIMIZED", "MAXIMIZED", "FULLSCREEN" and "EXCLUSIVE_FULLSCREEN".

(smgr) [ERROR] Resource is not type of PackedScene

You tried loading something that's not a scene into the SceneTree. Check against what you are loading first!

Common errors

(smgr) [ERROR] Failed adding <PLACEHOLDER> scene: Only one <PLACEHOLDER> scene is allowed

Only one scene can be loaded into the game and cutscene overlays. Perform a check against the overlay first! Click here for the smgr reference page

(smgr) [ERROR] Failed removing <PLACEHOLDER> scene: No <PLACEHOLDER> scene is active

You tried removing a scene in the game or cutscene overlay, but no scene is loaded in that overlay. Perform a check against the overlay first! Click here for the smgr reference page

(smgr) [ERROR] Failed adding <PLACEHOLDER> scene: <PLACEHOLDER> scene with name "<PLACEHOLDER>" already exists

You tried loading a scene into the menu or debug overlay, but another scene with the same name already exists in that overlay. Perform a check against the overlay first! Click here for the smgr reference page

(resmgr) [ERROR] Loading "<PLACEHOLDER>" failed: Resource is loaded already

You tried loading a resource with the resource manager, but a resource with the same name is loaded already. Perform a check against the resmgr first! Click here for the resmgr reference page

(resmgr) [ERROR] Unloading "<PLACEHOLDER>" failed: Resource is not present

You tried unloading a resource that is not loaded. Perform a check against the resmgr first! Click for the resmgr reference page

(resmgr) [ERROR] <Unloading/Loading> a batch failed: Batch is empty

The resource manager can't process a empty batch. Fill it with some information. Click for the resmgr reference page

Startup issues

coreinit -> CORE only supports Godot <PLACEHOLDER>. Please upgrade/downgrade your Godot Project to <PLACEHOLDER>.

Update or downgrade your Godot version to one that CORE supports. See the requirements page for more information.

coreinit -> The CORE logger is missing in your autoload project settings!

The CORE logger (found at res://CORE/logger.gd) is missing from your autoload list. Just add it under the name Logger and make sure to check Global variable.

coreinit -> The CORE preprocessor is missing in your autoload project settings!

The CORE preprocessor (found at res://CORE/preprocessor.gd) is missing from your autoload list. Just add it under the name Preprocessor and make sure to check Global variable.

coreinit -> The CORE configuration file (config.gd) is missing! Please copy the config.gd.example file and rename it to config.gd!

The CORE configuration file is missing. Just copy config.gd.example and rename it to config.gd. Make sure to update it to your likings.

coreloader.gd:46 @ _ready(): Resource file not found: res://.

The variable core_startupscript in CORE's config.gd file is empty or points to a missing script. Either set the variable or create a new initialization script.

Impossible errors

If you somehow encounter one of these errors, report them immediately please.

Failed attaching <PLACEHOLDER> to CORE: Invalid component

Failed attaching a CORE component (for example resmgr) to the CORE holder (core.gd).

Failed to get window mode: The window mode id "<PLACEHOLDER>" is not known to CORE.

Godot reported a window mode that CORE can't handle. Can be caused if the version check is removed and a higher Godot version is used than CORE supports.