Skip to content

added an addon installation page - #45

Open
zion8992 wants to merge 2 commits into
PixelGuys:mainfrom
zion8992:pyparsing
Open

added an addon installation page#45
zion8992 wants to merge 2 commits into
PixelGuys:mainfrom
zion8992:pyparsing

Conversation

@zion8992

@zion8992 zion8992 commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Changes in this PR

  • Added an 'How to install an Addon' page (under the development folder)

  • I also added 'pyparsing' to the pip requirements since Zensical was crashing without it.
    (I think it is @Argmaster who added it.)

  • I also fixed a typo in the FAQ page and fixed some broken links

  • Added icons to ever single addon-related page in the development/addons folder

---

## Biomes
Every biome is defined by a `zig.zon` file that contains all the data the world generator needs to generate it.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Every biome is defined by a `zig.zon` file that contains all the data the world generator needs to generate it.
Every biome is defined by a `<biome_name>.zig.zon` file that contains all the data the world generator needs to generate it.

Imo we should add a full name template to avoid confusion. Also adding sentence with examples could be a good idea.

---

## Blocks
Every block has a `zig.zon` file containing all the properties of each block.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Every block has a `zig.zon` file containing all the properties of each block.
Every block has a `<block_name>.zig.zon` file containing all the properties of each block.

Same as biomes.


## 2. Install the addon

Once you have your addon file, pick a Cubyz world to install it to, then open that Cubyz World's directory. You can find a folder button near the world name on the world selection screen in Cubyz that will open the world directory for you.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Definitely needs a screenshot.


Once you have your addon file, pick a Cubyz world to install it to, then open that Cubyz World's directory. You can find a folder button near the world name on the world selection screen in Cubyz that will open the world directory for you.

Once in your worlds directory, enter the `assets` folder and place your downloaded addon file into there. After that **extract** into a folder. If the folder name contains any character aside from letters 'a' to 'z', numbers '0' to '9' and '_', your game will crash.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Once in your worlds directory, enter the `assets` folder and place your downloaded addon file into there. After that **extract** into a folder. If the folder name contains any character aside from letters 'a' to 'z', numbers '0' to '9' and '_', your game will crash.
Once in your worlds directory, enter the `assets` folder and place your downloaded addon file into there. After that **extract** into a folder.

You repeated that part. It's already in debugging section.

Comment thread requirements.txt
zensical==0.0.50
jinja2>=3.1,<3.2
pydantic>=2.13,<2.14
pyparsing>=3.3.2

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
pyparsing>=3.3.2
pyparsing>=3.3.2,<3.4

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants