mirror of
https://github.com/celisej567/mcpe.git
synced 2026-09-11 20:11:18 +03:00
9a24abc603
* * Undo some of the changes done in the "* Work on survival mode." commit. * TEST_SURVIVAL_MODE is now on by default. * * Dying no longer crashes the game. * * Death seems to work ok. * * Improve some of the damage code. * x * work * Fixed the Makefile (#54) * * Finally fix the crack texture appearing to flicker/restart * * Add VS2010 as an optional target. Fix build with VS2010 (both windows_vs and xenon_vs). * * Disable survival mode. Getting ready to merge now! --------- Co-authored-by: Alexander Argentakis <38327951+MFDGaming@users.noreply.github.com>
128 lines
7.3 KiB
Markdown
128 lines
7.3 KiB
Markdown
# ReMinecraftPE
|
|
|
|
This project aims to create a custom Minecraft experience based on Minecraft: Pocket Edition as of 2011. It's based on the mcpe01_canada.apk build of the game.
|
|
Its goals are similar to [Minecraft Pi](https://minecraft.net/edition/pi) and [ClassiCube](https://github.com/UnknownShadow200/ClassiCube).
|
|
* Note: The original mcpe01_canada.apk does not work on newer Android devices. A port of this likely will.
|
|
|
|
### Planned ports:
|
|
* Raspberry Pi / Linux
|
|
* Android
|
|
|
|
### This is the main modded version. For the original decompilation, see [ReMinecraftPE/mcped](https://github.com/ReMinecraftPE/mcped)
|
|
|
|
## License information
|
|
|
|
This project is licensed under the [BSD 1 clause license](LICENSE.md). However, it contains third party software with different but compatible licenses:
|
|
|
|
- [RakNet](https://github.com/facebookarchive/RakNet): [Licensed under the BSD 2 clause license](thirdparty/raknet/LICENSE)
|
|
- [zlib](https://github.com/madler/zlib): [View license](thirdparty/zlib/LICENSE)
|
|
|
|
## WANT TO HELP?
|
|
|
|
Want to help this project? [Here's a list of things left to do.](TODO.md)
|
|
|
|
## DISCLAIMER
|
|
|
|
This project **requires** you to have a copy of the `mcpe01_canada.apk` (sha256: ``), before you can build.
|
|
|
|
## Setup
|
|
|
|
Before trying to build, load the sound assets into the `sound_data/` folder in the root of the project
|
|
by **running the following command**:
|
|
* `tools/grabsounds.py /path/to/the/mcpe01_canada/lib/armeabi-v7a/libminecraftpe.so`.
|
|
|
|
After that, **prepare the assets folder** from mcpe01_canada.apk. You will need it for the platform specific build.
|
|
|
|
### Windows (VS 2022)
|
|
|
|
This is simple enough - just open the project and compile.
|
|
|
|
After building, place the `assets` folder you have prepared in the working directory of the output executable.
|
|
(if running from VS, it's in `windows_vs/`, otherwise, in `windows_vs/bin/[x64/][Debug/Release]/`.
|
|
|
|
### Windows (VS 2010)
|
|
|
|
This target is only around to target Windows XP (or potentially earlier) versions.
|
|
|
|
To compile, you will **need the Microsoft Platform SDK and the DirectX (June 2010) SDK**. After that, follow the same steps as
|
|
the VS2022 build. (open the minecraftcpp_vs2010.sln project instead of the minecraftcpp.sln project).
|
|
|
|
### WebAssembly
|
|
|
|
First of all, place the `assets` folder into the `platforms/sdl/` directory.
|
|
Then run the `build-wasm` script corresponding to your platform (`-.sh` on linux/WSL, `-.bat` on windows).
|
|
|
|
The output files will be in `./wasm/dist`, but you need to upload them to a web host (localhost works too) to use. (problem with Emscripten)
|
|
|
|
**NOTE:** If you are using nginx, make sure the `*.wasm` file is served as `application/wasm`, and not `application/octet-stream`. This can be done by
|
|
opening `/etc/nginx/mime.types` as root and adding `application/wasm wasm;` to the types block.
|
|
|
|
## Have seams when playing?
|
|
|
|
I've had texture seams when playing Minecraft Classic, ClassiCube and this recreation of Minecraft PE. If seams bother you, and you are using an NVIDIA graphics card,
|
|
go to the NVIDIA Control Panel, then in "Manage 3D Settings", change "Antialiasing - Mode" to "Application Controlled".
|
|
|
|
## Notes on assets
|
|
The terrain.png and related textures appear to have stayed the same between the E3 demo and the final release for Xperia PLAY. It appears to have been fetched before
|
|
Java Edition Beta 1.4's release. This can be seen because the cookie's texture is missing. (it was added in Java Edition Beta 1.4)
|
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Known bugs
|
|
|
|
### Patched bugs
|
|
1. Due to lack of initialization of memory, fire can potentially burn normally inflammable blocks. See [this video](https://www.youtube.com/watch?v=3hrz7KK2EJs) for a demo.
|
|
2. Due to `SHAPE_FIRE` not being implemented, fire is invisible in this version. Fire rendering was backported from v0.7.1 and can be disabled with the `ORIGINAL_CODE` define
|
|
3. Due to `GL_BLEND` being disabled, the hotbar renders as fully opaque.
|
|
4. Memory is leaked when leaving a world with particles in it.
|
|
5. Stairs are invisible when held. To fix this, a fix has been backported from v0.1.1j
|
|
6. If the game is left on for approximately 1,242 days, the level will freeze, but the GUI will still be interactable.
|
|
|
|
The bugs can be "un-patched" by defining `ORIGINAL_CODE`. This allows compilation of an incomplete and mostly accurate recreation of MCPE for Xperia Play.
|
|
|
|
### Unpatched bugs
|
|
1. Particles with render texture 3 are invisible.
|
|
2. Potential freeze in `Entity::move`. If z_1 is between -0.04f and 0.04f, the game may freeze.
|
|
3. In `Particle::render`, the offset (`C_MAGIC_1`) is slightly larger than 1.0f / 16.0f. It's probably meant to be _smaller_ than 1.0f / 16.0f.
|
|
4. Ice doesn't properly cull faces, except on the y axis.
|
|
5. Fire is not extinguished on the server side.
|
|
6. Due to inaccuracies in level generation, some blocks may be different in multiplayer between a player on this version, and a player on the original MCPE.
|
|
|
|
## Enhancements
|
|
The original Minecraft: Pocket Edition had some missing details that make it feel like MCPE. Here are some enhancements that have been done:
|
|
|
|
* (`ENH_ENTITY_SHADING`) Make entity models have primitive shading
|
|
* (`ENH_SHADE_HELD_TILES`) Make in-hand block items have shading
|
|
* (`ENH_FIX_INVIS_STAIRS`) Fix 16x16x16 chunks of stairs rendering as invisible
|
|
* (`ENH_ALLOW_AO`) Allow enabling ambient occlusion (smooth lighting) using a hotkey (F4)
|
|
* (`ENH_TRANSPARENT_HOTBAR`) Allow the hotbar to be transparent. (See patched bugs #3)
|
|
* (`ENH_INSTA_BREAK`) Allow instant breaking of blocks
|
|
* (`ENH_CAMERA_NO_PARTICLES`) Hide particles from a camera's view. This hides the smoke particles that the camera emits, creating a clearer picture
|
|
* (`ENH_USE_JAVA_LIGHT_RAMP`) Use Minecraft: Java Edition Beta 1.6's light ramp code instead of the original (max brightness was only 0.8 in early versions of MC:PE for whatever reason)
|
|
* (`ENH_RUN_DAY_NIGHT_CYCLE`) Allow the day/night cycle to run
|
|
* (`ENH_ENABLE_9TH_SLOT`) Allow the 9th slot of the hotbar to be used instead of the unusable elipses (...)
|
|
* (`ENH_USE_OWN_AO`) Use a custom ambient occlusion engine (looks the same but fixes some corners)
|
|
* (`ENH_ADD_OPTIONS_PAUSE`) Add an "Options" button to the pause menu
|
|
* (`ENH_EXTRA_ITEMS_IN_INV`) Add extra items to a 5th row in the creative inventory
|
|
* (`ENH_HIGHLIGHT_BY_HOVER`) Highlight buttons when hovering over them instead of when using arrow keys
|
|
* (`ENH_ALLOW_SAND_GRAVITY`) Allow sand to fall
|
|
* (`ENH_USE_GUI_SCALE_2`) Use a GUI scale of 2 instead of 3 which looks better on PC (temporary)
|
|
* (`ENH_ALLOW_SCROLL_WHEEL`) Allow use of the scroll wheel to change selected inventory slots
|
|
|
|
Some of them can be turned on/off in `GameMods.hpp`, but the enhancement system is being phased out.
|
|
|
|
### Known bugs with enhancements
|
|
1. The camera's white overlay is fully opaque in shaded entity mode.
|
|
|
|
## Mods
|
|
In addition to enhancements, optional modifications to the base game were made. These mods are disabled by default but can be enabled in `GameMods.hpp`.
|
|
|
|
* (`MOD_USE_FLAT_WORLD`) Use a flat world instead of regular world generation (probably broken)
|
|
* (`MOD_USE_BIGGER_SCREEN_SIZE`) Use a bigger screen size of 1280x720 instead of 854x480
|
|
* (`MOD_DONT_COLOR_GRASS`) Don't tint the top of grass tiles with a different color (like Classic)
|