This is a project in which I aim to test my abilities and learn new skills, and show what I can do to the community thank you all very much for coming here and I hope you enjoy and are inspired to fire up IDLE yourself. Made with Python 3.7 64 bit and Windows Visual Studio Code for ease of use and id strongly recommend these!

Setup

Please first before you run the program can you make sure that you have all the files downloaded in the attached folder, then please keep them all inside the Pycraft file and don’t move them about inside the folder, as this makes the program crash and we don’t want that eh!

Also I might just add, this program will be compiled hopefully at the end of the development process in December 2021 or later into a .executable ".exe" file, however for now you will need to have python installed on your system, nothing fancy just the IDLE will do, and id recommend Python 3, I’m developing it on Python 3.7.7 although you should be alright with any Python 3 program.

Then please run the installer; "PycraftInstaller.py" this will make sure that all the modules the program needs to run are installed correctly, before you start complaining yes this is a very badly implemented program but it works for now and I do intend to sort this program out.

Running the program

Now you have the program properly installed hopefully (you’ll find out if you haven’t promptly!) you need to locate the file "PycraftRunUtil.py" basically all this program does is run the right modules, initiates the main program; "Pycraft.py" and catches any errors that might arise in the program in a nicely rendered error screen, if it crashes on your first run then chances are you haven’t installed the program correctly, if it still doesn’t work then you can drop me an email @ "ThomasJebbo@gmail.com" or comment here on the repository, I do hope however that it works alright for you and you have a pleasant experience. I might also add this program has been developed on a Windows 64-bit computer however should run fine on a 32-bit Windows machine or through MacOS although they remain untested for now.

I recommend creating a shortcut for the "PycraftRunUtil.py" file too so its easier to locate.

Credits

With thanks to;

:white_medium_square: Thomas Jebson
:white_medium_square: Python 3 @ https://www.bing.com/search?PC=U523&q=python&pglt=299&FORM=ANNTA1#
:white_medium_square: OpenGL @ https://www.opengl.org/
:white_medium_square: Pypi @ https://pypi.org/
:white_medium_square: Pillow (PIL) @ https://python-pillow.org/
:white_medium_square: Pygame @ https://www.pygame.org
:white_medium_square: Windows 10 - Visual Studio Code @ https://code.visualstudio.com/
:white_medium_square: Freesound: - Erokia's "ambient wave compliation" @ https://freesound.org/s/473545/
:white_medium_square: Freesound: - Soundholder's "ambient meadow near forest" @ https://freesound.org/s/425368/
:white_medium_square: Blender @ https://www.blender.org/ :white_medium_square:

Dependencies

in case you don't know you can install Pycraft's required modules manually or through the soon to be overhauled installer; named "PycraftInstaller.py" through your Control Panel in Windows (First; press the windows key + r then type "cmd" then run the below syntax) or on Apple systems in Terminal.

pip install <module>
pip uninstall <module>
pip update <module>

Installing, uninstalling or updating the specified module respectively; pip is usually installed by default when installing Python with most versions.

:white_medium_square: Python: Os
:white_medium_square: Python: Sys
:white_medium_square: Python: Random
:white_medium_square: Python: Time
:white_medium_square: Python: Csv
:white_medium_square: Python: Timeit
:white_medium_square: Python: Subprocess
:white_medium_square: Python: Pip
:white_medium_square: Python: Array
:white_medium_square: Pygame >= 2.0.1
:white_medium_square: PyOpenGL >= 3.1.5
:white_medium_square: Numpy >= 1.20.3
:white_medium_square: PyAutoGUI >= 0.9.52
:white_medium_square: PyWaveFront >= 1.3.3
:white_medium_square: Psutil >= 5.8.0
:white_medium_square: PIL (Pillow) >= 8.2.0
:white_medium_square: Tkinter

Disclaimer; unfortunately lots of these python modules (first and third party) can require some external modules that will be installed during the installing process of the above modules, unfortunately this makes it really difficult to give credit to those modules, if you have any recommendations please contact me appropriately.

Changes

In this new sub-release we have patched a lot of bugs; all the ones as far as I am aware of all have been fixed excluding the installer program that is soon to be discontinued and updated:
:white_medium_square: Fixed audio bugs: both continuing to play when errors occur and in installer and when loading other menus & fixed the bug when the sound will only play once in the menu after 10 minutes of sound playing
:white_medium_square: Fixed errors in the error exception module with font and initialized modules.
Again feedback would be much appreciated, and this version was released on; 09/05/2021 (UK date) DD/MM/YYYY. As always we hope you enjoy this new release and feel free to leave feedback. Thank you! And the issues we encountered uploading files to the required locations on GitHub have since been resolved for your convenience.

Plans for the future

Performance improvements; maybe faster load times and settings description in sub-version Pycraft-21p1003-21a06
Massive installer overhaul in sub-version Pycraft-21p0103-21a07
Then...
A final bug fix update before releasing the next Pycraft version!!!

Our update policy

New releases will be introduced regularly, it is likely that there will be some form of error or bug, therefore unless you intend to use this project for development and feedback purposes (Thank you all!) we recommend you use the latest stable release; below is how to identify the stable releases.

Version naming

Our individual versions is labelled individually following the format below: eg: 21p1003-21a This is (Date), (First letter of name of game), (Big release ID), (Month), (-), (Year), (Alpha/Beta) Any Unstable releases will also have in addition to the following format, a release code at the end, starting from 01, these indicate how many new revisions there have been before the last large update.

## Final Notices

Thank you greatly for supporting this project simply by running it, I am sorry in advance for any spelling mistakes. The programs will be updated frequently and I shall do my best to keep this up to date too. I also want to add that you are welcome to view and change the program and share it with your friends however please may I have some credit, just a name would do and if you find any bugs or errors please feel free to comment in the comments section any feedback so I can improve my program, it will all be much appreciated and give as much detail as you wish to give out. BY INSTALLING THIS PROJECT ONTO YOUR COMPUTER AND RUNNING IT I; Tom Jebbo DO NOT TAKE ANY RESPONCIBILITY FOR ANY DAMAGES THIS MAY CAUSE HOWEVER UNLIKELY, AND YOU AGREE TO HAVE EXERNAL MODULES INSTALLED ONTO YOUR COMPUTER ALSO, OF WHICH I HAVE NO CONTROL OVER, PLEASE USE THIS PROGRAM RESPLONCIBLY AND DO NOT USE IT TO CAUSE HARM. YOU MUST ALSO HAVE PERMISSION FROM THE DEVISES MAGAGER OR ADMINISTRATOR TO INSTALL AND USE COMMAND PROMPT OR TERMINAL. NO DATA THIS PROGRAM COLLECTS IS STORED ANYWHERE BUT, ON YOUR DEVISE, AND AT ANY POINT NO CONNECTION TO A NETWORK IS REQUIRED, AFTER INSTALLATION, TO RUN THIS PROGRAM. THIS PROGRAM DOES NOT SEND ANY DATA TO THE DEVELOPER OR ANYONE ELSE ABOUT THIS PROGRAM. Thank you