celisej567/mcpe
1
0
Fork 0
mirror of https://github.com/celisej567/mcpe.git synced 2026-09-11 20:11:18 +03:00
Code Issues Actions Packages Projects Releases Wiki Activity

* Update the readme slightly

Browse Source 
-- Add clarification on build steps for linux
-- Uniformize line widths to a maximum of 125 chars.
This commit is contained in:
iProgramInCpp
2023-08-23 23:20:01 +03:00
parent 3388c773f9
commit 5985e0d83b
1 changed files with 48 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
README.md
View File

@@ -1,12 +1,17 @@
# 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.
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:**
* To add Quality-of-Life features to Minecraft: Pocket Edition, such as a brighter color gamut, an in-game options menu, etc.
* To add features that were in Minecraft Alpha and the early Betas in 2011. (before and during Minecraft PE's development - this excludes hunger, for example, as it was added in Beta 1.8)
* To keep the source code layout similar to the original Minecraft PE (reconstructed from clues hidden within certain versions of the game, such as the 0.1.0 touch prototype/debug build)
* To port the game to more platforms, such as Windows (including older versions), Linux, WebGL, Android, and macOS. Currently we have ports for:
* To add Quality-of-Life features to Minecraft: Pocket Edition, such as a brighter color gamut, an in-game
options menu, etc.
* To add features that were in Minecraft Alpha and the early Betas in 2011. (before and during Minecraft PE's
development - this excludes hunger, for example, as it was added in Beta 1.8)
* To keep the source code layout similar to the original Minecraft PE (reconstructed from clues hidden within
certain versions of the game, such as the 0.1.0 touch prototype/debug build)
* To port the game to more platforms, such as Windows (including older versions), Linux, WebGL, Android, and
macOS. Currently we have ports for:
* Windows 10/8/7
* Windows XP/Vista
* Linux
@@ -19,7 +24,8 @@ This project aims to create a custom Minecraft experience based on Minecraft: Po
* Backport features from versions newer than 0.9.0
* Add The Nether or The End (probably)
* Add Herobrine
* Add support for Minecraft Java or Minecraft Bedrock servers. (although LAN play with original MCPE clients will be supported for as long as possible)
* Add support for Minecraft Java or Minecraft Bedrock servers. (although LAN play with original MCPE clients
will be supported for as long as possible)
* Modify the project structure
Note: The original mcpe01_canada.apk does not work on newer Android devices. A port of this likely will.
@@ -28,7 +34,8 @@ Note: The original mcpe01_canada.apk does not work on newer Android devices. A p
## 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:
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)
@@ -39,7 +46,8 @@ 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: `74b1d3b51a174c4dcaaa58d2bbdf7a4f4c9cfe5f2aeec4844427c2b8f1124343`), before you can build.
This project **requires** you to have a copy of the `mcpe01_canada.apk` (sha256 of the `libminecraftpe.so`
inside: `74b1d3b51a174c4dcaaa58d2bbdf7a4f4c9cfe5f2aeec4844427c2b8f1124343`), before you can build.
## Setup
@@ -47,7 +55,8 @@ Before trying to build, load the sound assets into the `sound_data/` folder in t
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.
After that, **prepare the assets folder** from mcpe01_canada.apk. You will need it for the platform specific
build.
## Building
@@ -62,30 +71,45 @@ After building, place the `assets` folder you have prepared in the working direc
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).
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).
**Note!** If you are running from within VirtualBox, disable mouse integration (absolute mouse), or the camera won't work properly.
**Note!** If you are running from within VirtualBox, disable mouse integration (absolute mouse), or the camera
won't work properly.
### WebAssembly
The game will use the assets from within the `game/` directory. So put your assets there if you want to build for wasm.
Then run the `build-wasm` script corresponding to your platform (`-.sh` on linux/WSL, `-.bat` on windows).
**Make sure you have CMake and Ninja installed. On Windows, the ninja executable must be in your PATH.**
On Linux, the package names are `cmake` and `ninja-build` respectively if you are using apt.
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)
The game will use the assets from within the `game/` directory. So put your assets there if you want to build
for wasm. Then run the `build-wasm` script corresponding to your platform (`-.sh` on linux/WSL, `-.bat` on
windows).
**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.
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.
## Linux
You will need `libopenal-dev` and `libsdl2-dev` to play (the package names for OpenAL and SDL2 respectively,
if you are using apt). Then simply run the makefile with the `make` command.
## Have seams when playing?
I've had texture seams when playing Minecraft Classic, ClassiCube and this recreation of Minecraft PE, on a fresh new laptop. 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".
I've had texture seams when playing Minecraft Classic, ClassiCube and this recreation of Minecraft PE, on a
fresh new laptop. 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)
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 (from the decomp)
@@ -97,5 +121,6 @@ Java Edition Beta 1.4's release. This can be seen because the cookie's texture i
## Enhancements
All enhancements (and more) that are available in the decomp version are turned on by default, but only some of them can be disabled, and the GameMods.hpp file used
to control them is deprecated and will be removed. Check the decomp version's repository for a partial list of enhancements that were added to the game.
All enhancements (and more) that are available in the decomp version are turned on by default, but only some
of them can be disabled, and the GameMods.hpp file used to control them is deprecated and will be removed.
Check the decomp version's repository for a partial list of enhancements that were added to the game.