Skip to content

MiniPyEngine v1.0.1-Stable – Public Test Release

Choose a tag to compare

View all tags
@EgeOnderX EgeOnderX released this 31 Jul 11:25
· 93 commits to main since this release
v1.0.1
4febd5d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

MiniPyEngine 1.0.1-S

MiniPyEngine is a heavily improved and restructured version of a game engine originally created by Alexander Freyr Lúðvíksson in 2023.

This version was developed and extended by Ege in 2025 under the MIT License.

Features

  • Uses .obj and .mtl files for models and textures. (Does not support .glb format.)
  • Supports a wide range of resolutions:
    • HD (1280×720)
    • Full HD (1920×1080)
    • 2K / QHD (2560×1440)
    • 4K / UHD (3840×2160)
    • 8K (7680×4320)
    • 16K (15360×8640)

What's New in MiniPyEngine 1.0.1-S

  • Added Game Maker App Button, NOT the app ( Comes in v1.0.3 )
  • Multiplayer removed (But still it needs shortuuid)
  • Added support for 8K for fun, added 16K resolution!
  • Fixed crouch-jump bug
  • Various bug fixes and internal improvements
  • VGA and SVGA resolution support removed for stability
  • Added console menu.
  • Added modulechk system.

Known Bugs

  • None reported.

Controls (default Player.py)

  • Move: W, A, S, D
  • Run: Hold Shift
  • Jump: Space
  • Crouch: Ctrl
  • Look around: Move the mouse
  • Shoot / Interact: Left-click
  • Pause menu: Esc
  • Press f3 to open console.

How to Launch

  1. Double-click main.py.
  2. In the menu, click the Settings button to configure resolution and other options.
  3. If the game doesn't launch:
    • Open the config file with a text editor (e.g., Notepad).
    • Verify the configuration settings.
  4. Finally, run StartGame.py to start the game.

Screenshots:

Main Menu:

main

Console Menu:

console

Module Verification System:

modulechk

System Requirements

Minimum:

  • OS: Windows 10 / Linux (Ubuntu 18.04+)
  • Python: 3.8+
  • CPU: Dual-core 2.0 GHz
  • RAM: 80 MB (game usage only)
  • GPU: Integrated graphics with OpenGL 3.3 support
  • Storage: 20 MB free space
  • Dependencies:
    pygame, PyOpenGL, numpy, ***shortuuid***, psutil

NOTE: You might think shortuuid is only needed when there is multiplayer, but since we gradually removed it step by step, it is still necessary to prevent corruption.

Technical Overview

MiniPyEngine uses modern OpenGL with custom GLSL shaders for advanced graphics, going beyond the fixed-function pipeline.
Shaders are compiled at runtime from the shaders/ directory.

To create your own game:

  • Modify Player.py
  • Add .obj, .mtl, and texture files
  • Register your objects in the objects/ folder
  • You can create your own map by editing the level1.py file.

NOTE: For a super silly map filled with boxes, replace the level1 file in the maps folder with the original level1

The sound system contains only sample sounds!

Console Commands

  • Type 'god' to enable God Mode (health set to 9999).
  • Type 'noclip' to pass through walls.
  • Type 'nocrouch' to disable/enable crouching.
  • Type 'nojump' to disable/enable jumping.
  • Type 'exit' to close the console.

License

MIT License

Original Copyright (c) 2023 Alexander Freyr Lúðvíksson
Modified into MiniPyEngine by Ege, 2025

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Planned Features for Future Versions

  • Better performance and optimizations
  • Enhanced graphics/rendering pipeline
  • Additional platform support
  • Complete map file system
  • NPC system
  • Expanded documentation and tutorials

If you downloaded or used this project, thank you for trying out MiniPyEngine!

Assets 2
Loading