MrSquidson / MaeStore

Django application for storing and viewing minecraft books from the web

Maestore

A Project to Collect and Preserve

What is Maestore?

Maestore is a project in simmilar scope as Civbooks. Maestore aims to collect and preserve books from the Stoneworks worldbuilding server which are either...

A. No longer available due to a World Shutdown

B. Not widely available, and no longer produced (Copies of Copies) by the Author or sellers

Installation

Note

Ensure you have an instance of Python 3.11.1 or Newer installed on your machine

1. Clone this repo
2. Navigate to the downloaded repository cd maestore
3. Create a virtual environment
   • Install poetry pip install poetry
   • Install dependancies poetry install
4. Run the following lines.

   py manage.py makemigrations
   py manage.py migrate

5. Create your first admin user
   • run py manage.py createsuperuser and follow the instructions in your terminal
6. Run the django application. py manage.py runserver
7. You can now find Maestore open on your localhost!
   • To kill your local instance close the terminal or force a break. (ctrl+c)

Adding books

1. Open the /upload/ page.
2. Upload a .stendhal file

Important

Stendhal files are generated using the Stendhal mod for Minecraft (Download the mod on Modrinth)

3. Press the "Upload" button.
4. Check the /index/ page (You should automatically be redirected here after upload)
5. (Optional) Check out the archive/manual entry on the /admin/ page
   • This is done using the superuser/admin account created during installation