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! This update is going to take a few days to be released fully, please bear with us.

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 however Python 3 and any version is recommended.

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;

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

• Python: Os
  
• Python: Sys
  
• Python: Random
  
• Python: Time
  
• Python: Csv
  
• Python: Timeit
  
• Python: Subprocess
  
• Python: Pip
  
• Python: Array
  
• Pygame >= 2.0.1
  
• PyOpenGL >= 3.1.5
  
• Numpy >= 1.20.3
  
• PyAutoGUI >= 0.9.52
  
• PyWaveFront >= 1.3.3
  
• Psutil >= 5.8.0
  
• PIL (Pillow) >= 8.2.0
  
• 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 few more known bugs, although the more data we receive with regards to errors and problems and glitches the less buggy an update will be.
- Started work on creating the new installer with the old one pending depreciation, no changes however will be released in this update to allow the developers to have more time polishing it, and testing it in as many different situations as they can, but for your information the setup of the installer is complete and also the installation, the rest of the updates are occurring in a "spider" fashion, which will be explained later.
- Implemented splash text on the main load screen
- Considerably faster game load times in the main load menu
- Started work connecting the python project to the internet to install updates to the game and modules and this too will be implemented in the "spider" development structure.

Again feedback would be much appreciated, and this version was released on; 10/06/2021 (UK date) DD/MM/YYYY. As always we hope you enjoy this new release and feel free to leave feedback. Thank you! we also apologize for the slow updates over the past few days, development has been slow due to issues with the new installer and its implementation, hence why it is not in this pre-release of Pycraft.

Plans for the future

Settings labels will be introduced soon
Massive installer overhaul coming soon
A final bug fix and error checking update before releasing the next Pycraft version, and we are going to then be making a huge change to the labelling system, we will be moving to a more semantic labelling structure.
Further down the line more C integration, as well as game engine updates and physics updates are likely to occur, as well as forcing the skybox to the camera and maybe even rasterization.

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.

This unique release

This version of Pycraft is slightly special, by downloading the (.exe) file below you can run Pycraft with all the required modules, files and code all in one file for your ease of use, this program does not install any extra files unlike the main Pycraft python project or change any system files or anything like that on your computer. This release does not merit any performance improvements unfortunately. To remove this from your computer just delete the file, for now. This was done because we understand here at Pycraft that a lot of people don't want to install python or don't feel comfortable installing additional files to their PC so this bypasses all those issues. This is likely to be a feature of all future releases, and definitely a feature of the main release, which I hope to have scheduled for September, however this isn't set in stone and many releases afterwards will occur.

Spider Development

You might be wondering, what on earth we mean by "spider development", and what will that mean for me, in short this means that as developers we will update the program and run tests on it by changing and working on different features at different times, perhaps when techniques become available or when we feel it is ready for implementation, this does not mean that updates or development will incur a delay, it simply allows us to work on multiple features independently from the rest of the game so features might be built up over a series of updates.

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. PLEASE USE THIS PROGRAM RESPONCIBLY AND DO NOT USE IT TO CAUSE HARM. YOU MUST ALSO HAVE PERMISSION FROM THE DEVISES MAGAGER OR ADMINISTRATOR OR OWNER TO INSTALL. NO DATA THIS PROGRAM COLLECTS IS STORED ANYWHERE BUT, ON YOUR DEVISE, AND AT ANY POINT NO CONNECTION TO A NETWORK IS REQUIRED HOWEVER RECOMENDED TO KEEP THE MODULES AND GAME UP TO DATE, AFTER INSTALLATION, TO RUN THIS PROGRAM. THIS PROGRAM DOES NOT SEND ANY DATA TO THE DEVELOPER OR ANYONE ELSE ABOUT THIS PROGRAM. Thank you.