ddevault / truecraft Goto Github PK

Minecraft for hipsters

License: MIT License

C# 99.86% Python 0.12% Shell 0.02%

truecraft's Introduction

A completely clean-room implementation of Minecraft beta 1.7.3 (circa September 2011). No decompiled code has been used in the development of this software. This is an implementation - not a clone. TrueCraft is compatible with Minecraft beta 1.7.3 clients and servers.

Screenshot taken with Eldpack

I miss the old days of Minecraft, when it was a simple game. It was nearly perfect. Most of what Mojang has added since beta 1.7.3 is fluff, life support for a game that was "done" years ago. This is my attempt to get back to the original spirit of Minecraft, before there were things like the End, or all-in-one redstone devices, or village gift shops. A simple sandbox where you can build and explore and fight with your friends. I miss that.

The goal of this project is effectively to fork Minecraft. Your contribution is welcome, but keep in mind that I will mercilessly reject changes that aren't in line with the vision. If you like the new Minecraft, please feel free to keep playing it. If you miss the old Minecraft, join me.

Compiling

Use a recursive git clone.

git clone --recursive git://github.com/SirCmpwn/TrueCraft.git

You need to restore Nuget packages. The easiest way is to open the solution up in monodevelop or visual studio or the like and build from there. You can alternatively acquire Nuget yourself and run this:

mono path/to/nuget.exe restore

From the root directory of the git repository. Then run:

xbuild

To compile it and you'll receive binaries in TrueCraft.Launcher/bin/Debug/. Run [mono] TrueCraft.Launcher.exe to run the client and connect to servers and play singleplayer and so on. Run [mono] TrueCraft.Server.exe to host a server for others to play on.

Note: if you have a problem with nuget connecting, run mozroots --import --sync.

Note: TrueCraft requires mono 4.0 or newer.

Get Involved

If you are not a developer, you can keep up with TrueCraft updates and participate in the community on /r/truecraft, or by joining us to chat in #truecraft on irc.esper.net.

If you are a developer, you have two paths. If you have not read the Minecraft source code, you are what we call a "clean dev", and you should stay that way. If you have read the source code, you are what we call a "dirty dev", and the way you can contribute is different. If you are a clean dev, you're welcome to contribute to this repository by adding features and functionality from Minecraft Beta 1.7.3, fixing bugs, refactoring, etc - the usual. Send pull requests with your work.

If you are a dirty dev, you are more limited in how you can help. You can work on projects that are related to TrueCraft, but not on TrueCraft itself. Direct contributions that you can participate in includes the website and the artwork. You can also work on things like helping to build a community by spreading the word, participating in IRC or the subreddit, etc. You may also work on reverse engineering Minecraft to provide documentation for clean devs to use - see reverse engineering guidelines on the wiki for details on how you can do this. Under no circumstances may you ever share any code with a clean dev, decompiled or otherwise.

Assets

TrueCraft is compatible with Minecraft beta 1.7.3 texture packs. We ship the Pixeludi Pack (by Wojtek Mroczek) by default. You can install the Mojang assets through the TrueCraft launcher if you wish.

Blah blah blah

TrueCraft is not associated with Mojang or Minecraft in any sort of official capacity.

truecraft's People

Contributors

Stargazers

Watchers

Forkers

nirad greatman creatorfromhell macsummer jorik jei0731 catmanjan liambaloh oneminot liamzebedee mkgobaco ncarrillo-zz wayward1 jeremycbrooks tanoaks bradparks sangohan brendanbuono drooids nbering jacobmarshall-etc sandhose lyrl ezhangle lepulana robinkanters manio143 andy7731 derek-smith zuiyueyin mitch528 nathanial thekingofpython maugus33 jobava-minecraft suicvne const586 kayleesmall blha303 illblew thdtjsdn prodigeni minecraftsources snys98 christopherbauer prusinek74 kusl minecraftrules9707 maxleiter khazarak austinbryan wuonly biggsun andrew889 imjerrybao ricucremop dtrayn ffpwserver jaku255 ygjb whitekakari corefan piperswe cojo31793 kleopatra999 rcjavier harry-cpp sfears peroalane simisu dersandmann-badcode ernest33 jdc20181 begust maniacs-games pracplayllc projecthj artganify aubreyfletcher6682 teotikalki gongfupanada nemolee berlamont wongfree ranger1230 sirdragonclaw ficture7 nicecapj marslabtron nagyistge snoworld888 xzlxiao ninjanody oizma unalkalkan leen89757 frankwu2016 coderxlsn ikostan bmjoy

truecraft's Issues

Oceans are broken

This bug occurs on the latest version of TrueCraft (4f66305).

Discussion - differences in rendering between Minecraft and TrueCraft

To what degree is it acceptable for TrueCraft to look different than Minecraft? Here's an example that just came up:

From the bottom, torches are not fully modeled in vanilla minecraft:

In the TrueCraft implementation, torches have a bottom:

Which is better? Is it okay for us to deviate like this?

Implement world persistience

Saving worlds to disk (in anvil format) needs to be implemented.

Spawning underground

I'm not sure if it happens often, but when a new player logs in and is in a block underground, it's not good. It should check if there's air two blocks up from the feet position.

Items lie on top of tall grass

I expected dropped items to fall through tall grass

What is this game exactly?

Cannot throw items diagonally

Hitting a snow tile will yield a snow tile item

Place snow on the ground
Hit the snow with fist

Issue: a piece of snowtile pops up

I expected a snowball to 'drop'

AVG False Flag

AVG marks the compiled TrueCraft.exe (in the Debug folder) as a virus with type 'unknown' upon running - I will submit this to AVG as a false flag, however it would be good if you had any idea what may be triggering this

Code Analysis errors

Below is a list of Code Analysis errors in a Pastebin, we should go through case by case and suppress them or fix them

http://pastebin.com/JY9nmGiB

Create installer

We should have a Windows installer. I've done one in the past that worked pretty well for Patchy, we should follow a similar strategy.

Dropped items are spasming on the ground

Dropped items (seem to randomly) jump up and down the Z-axis.

My guess is that the server and client can't agree on the Z-position of the item

Spawn item entities when items are left in crafting areas

Remove scheduled events when they become obsolete

We could use some way to remove scheduled events from the event queue when they are no longer needed. For example, when a client disconnects, all of their events keep on chugging along.

Falling sand

Falling sand has been checked off, however I'm still getting a lot of weird behaviour with falling sand, is that not a server problem?

Blocks are still removed from inventory even when they are not successfully placed

Steps to reproduce:

Give yourself n torches (where n > 0)
Place/find a glass back
Attempt to place a torch against the side of the glass block

Expected Results
The torch is not placed and you still have n torches in your inventory.

Actual Results
The torch is not placed and you have n-1 torches in your inventory.

Handle entity equipment

This involves sending armor to clients and the relevant inventory stuff to handle that.

/give command

I've done a few improvements to the /give command tonight, but I'd still like to discuss/propose 2 features:

/giveme as shortcut so you don't have to type out your name if you want to give yourself
Possibility to give items by entering the start of someone's name. this exists in Minecraft, and I'd like to see it as a global utility (FindPlayerByPartialUsername, or something like that). Might come in handy in a lot of other places.

The first one is really easy, for the second one, though, I wouldn't immediately know where to start. Thus, before spending a lot of effort and possibly not using a very pretty solution, I'd like to discuss them.

However, I'm going to bed now, so good night 😴

I've read MC source. AMA.

Unfortunately, I have read deobfuscated MC source and can't contribute. However, if you need a question about something behaves answered, feel free to ask me and I can check the source.

Doesn't build in fedora

Monodevelop complains about YamlDotNet (a nuget package) not being available. When trying to install nuget packages, I get this:

I am using:

$  mono --version
Mono JIT compiler version 2.10.8 (tarball Sun Aug 17 19:00:51 UTC 2014)
Copyright (C) 2002-2011 Novell, Inc, Xamarin, Inc and Contributors. www.mono-project.com
    TLS:           __thread
    SIGSEGV:       altstack
    Notifications: epoll
    Architecture:  amd64
    Disabled:      none
    Misc:          debugger softdebug 
    LLVM:          supported, not enabled.
    GC:            Included Boehm (with typed GC and Parallel Mark)

Is there anything I am missing?

build broken with error regarding YamlDotNet

I followed the build instructions in the README, and got this error:

/home/luke/tmpstore/build/TrueCraft/TrueCraft/TrueCraft.csproj (default targets) ->
/usr/lib/mono/4.5/Microsoft.CSharp.targets (CoreCompile target) ->

        Program.cs(14,7): error CS0246: The type or namespace name `YamlDotNet' could not be found. Are you missing an assembly reference?
        Configuration.cs(3,7): error CS0246: The type or namespace name `YamlDotNet' could not be found. Are you missing an assembly reference?

         19 Warning(s)
         2 Error(s)

I'm using latest mono as per these instructions: http://www.mono-project.com/docs/getting-started/install/linux/#debian-ubuntu-and-derivatives

Thanks!

Implement entity tracking and physics

Most of this can be taken from Craft.Net.

Usernames in logs are prefixed by the chat color identifier

The SendMessage method in the MultiplayerServer class should probably remove the chat color before writing the message to the log, otherwise we'll get messages like the one above.
~~I'd suggest a Regex fix which I have included in the commit (removed)~~

Free (as in freedom) resources for TrueCraft use

Starting this thread to collect ideas for resources (sound, music, textures) that we can use for TrueCraft.

https://github.com/deathcap/ProgrammerArt - CC texture pack we may be able to leverage

Allow placement of torches etc. on interactive blocks

Placing a torch on an invalid surface of a solid block will force it to attach to any valid solid block reachable from that location.
ex. placing a torch on the bottom of a solid block 2 blocks above a chest.

Screen-Door Transparency

Unless I'm forgetting something, every "transparent" material in b1.7.3 Minecraft can be correctly rendered using a technique called "Screen Door Transparency". The primary benefit of this technique is that you don't need to depth sort, but it requires that each pixel in a texture be either 0% or 100%.

See the first part of this article for a better description.

Implement weather cycle

Change between weather states
Lightning
Snowfall

Implement smelting

List of features for eventual backporting

The current list of features that are planned for backporting. Suggest more in this thread.

Client - don't draw unnecessary vertices.

Currently, the client renders all vertices of all faces (example here, with all blocks being drawn at half extent to make the overdraw visible):

There are two main ways you can reduce this:
For solid blocks

Add a 'IsSolidFace(Face...' method to BlockProvider. You can skip drawing a face when the face on this block is solid and the corresponding face on the neighbouring block is also solid.
(There are some corner cases. For example, cactus would only be true for Y positive and Y negative)

For transparent and transluscent blocks, you can do this:
2) Add a 'CanShareWithNeighbours(Face...' method to BlockProvider. You can skip drawing a face when a block and its neighbour are the same type. (e.g. for glass, water)
(Note that water is a bit trickier - for horizontal neighbours, you have to make sure that they have the same height and shape)

List of terrain features that need implemented

PCL support

How about convert TrueCraft to PCL?
I have something that I can call a "client". Runs on mobile platforms and blah blah. Still sucks a bit. Would be cool if I could run both client and server on, for example, android.
Will help, of course.

Minecraftish font needed

Need a volunteer to make a font that is in the spirit of Minecraft. Should be an image (PNG) that includes characters for the ASCII set (everything less than 0x7F, feel free to omit control chars).

For reference, here's the original Minecraft font image. The TrueCraft font needs to be compatible (i.e. same characters in the same places).

I'm able to place blocks where I'm standing

Custom chat colors

When starting to implement the custom client, I don't think it would be a bad idea to implement custom chat colors for modding support.

E.g. instead of using the predefined colors like $9 for blue, a mod could use RGB values like $(0,116,217) for a slightly nicer blue.

Too rad?

Implement shapeless recipes

i.e. torches

Contributing.md

There is currently no contributing.md, some information on how to contribute would be beneficial.

Implement world logic

The big list of things you can do in Minecraft that need to be supported in TrueCraft.

When working on one of these, reference the issue number ("#12") in your commit messages.

ALL THE FLOWERS

I think this is... a bit much...

Build instructions are too scarce

I'm on Debian jessie 64-bit, installed xbuild from packages. I followed the instructions in the README, typed xbuild in the TrueCraft folder (cloned from Git recursively) and got:

XBuild Engine Version 12.0
Mono, Version 3.2.8.0
Copyright (C) 2005-2013 Various Mono authors

Build started 01/05/2015 14:36:00.
__________________________________________________
Project "/home/calinou/Git/truecraft/TrueCraft.sln" (default target(s)):
    Target ValidateSolutionConfiguration:
        Building solution configuration "Debug|x86".
    Target Build:
        Project "/home/calinou/Git/truecraft/externals/fNbt/fNbt/fNbt.csproj" (default target(s)):
            Target PrepareForBuild:
: error : Error initializing task Message: Could not load file or assembly 'Microsoft.Build.Tasks.v4.0' or one of its dependencies. The system cannot find the file specified.
            Task "Message" execution -- FAILED
            Done building target "PrepareForBuild" in project "/home/calinou/Git/truecraft/externals/fNbt/fNbt/fNbt.csproj".-- FAILED
            Target _RecordCleanFile:
: error : Error initializing task ReadLinesFromFile: Could not load file or assembly 'Microsoft.Build.Tasks.v4.0' or one of its dependencies. The system cannot find the file specified.
            Task "ReadLinesFromFile" execution -- FAILED
            Done building target "_RecordCleanFile" in project "/home/calinou/Git/truecraft/externals/fNbt/fNbt/fNbt.csproj".-- FAILED
        Done building project "/home/calinou/Git/truecraft/externals/fNbt/fNbt/fNbt.csproj".-- FAILED
    Task "MSBuild" execution -- FAILED
    Done building target "Build" in project "/home/calinou/Git/truecraft/TrueCraft.sln".-- FAILED
Done building project "/home/calinou/Git/truecraft/TrueCraft.sln".-- FAILED

Build FAILED.
Errors:

/home/calinou/Git/truecraft/TrueCraft.sln (default targets) ->
(Build target) ->
/home/calinou/Git/truecraft/externals/fNbt/fNbt/fNbt.csproj (default targets) ->
/usr/lib/mono/4.5/Microsoft.Common.targets (PrepareForBuild target) ->

    : error : Error initializing task Message: Could not load file or assembly 'Microsoft.Build.Tasks.v4.0' or one of its dependencies. The system cannot find the file specified.

/home/calinou/Git/truecraft/TrueCraft.sln (default targets) ->
(Build target) ->
/home/calinou/Git/truecraft/externals/fNbt/fNbt/fNbt.csproj (default targets) ->
/usr/lib/mono/4.5/Microsoft.Common.targets (_RecordCleanFile target) ->

    : error : Error initializing task ReadLinesFromFile: Could not load file or assembly 'Microsoft.Build.Tasks.v4.0' or one of its dependencies. The system cannot find the file specified.

     0 Warning(s)
     2 Error(s)

Time Elapsed 00:00:00.1781310

What do I need to do for it to build? I've never built a C# program before, so I have no idea what to do.

Also, does TrueCraft require game data from Minecraft? You should probably mention it in the README; if it does, I can work on getting replacement data for those who don't have Minecraft.

Launcher written with xwt

I would like to see a TrueCraft launcher built with Mono xwt (cross platform GUI toolkit for C#). Our launcher will do a bit more than the Minecraft launcher, including:

Browsing through your singleplayer worlds
- Launching a server and running TrueCraft.Client to connect to it for singleplayer
Storing and browsing your saved server list
Login and so on

A vertically placed torch is not destroyed when its supporting block is mined

Torche placement still buggy

Possibly a regression. Orientation of placed torches is not being stored correctly by the server. Once the client unloads the chunk, then reloads it, torches will have the wrong orientation.

Enforce correct digging time for players

Implement mobs and AI

Friendly:

Passive:

Agressive:

Misc:

Implement A* (with Jump Point Search)
Implement spider jockey

Client - Ways to reduce memory usage.

In ChunkHandler.HandleData(), you already know the total uncompressed size of the data. You could use a memory stream with this total size to avoid having to do any resizing operations. (You'll have to manually decompress though, instead of using ZLibStream.UncompressBuffer)

~~2) Why are you using storing the drawable coordinates in ChunkConverter.ProcessChunk()? Can't you just directly call the RenderBlock method?~~

You probably shouldn't be returning arrays in BlockRenderer.CreateQuad, as this allocates a lot of memory.(CLRProfiler showed ~570 megabytes) Probably a better way would be to pass an index parameter as ref and increment that. I am not sure if this works correctly, but here's one way I came up with:

        protected VertexPositionNormalTexture[] CreateUniformCube(Vector3 offset, Vector2[] texture, int indicesOffset, out int[] indices) {
            indices = new int[6 * 6];
            var vertices = new VertexPositionNormalTexture[4 * 6];
            int textureIndex = 0;
            int verticesLocIndex = 0, indicesLocIndex = 0;
            for (int side = 0; side < 6; side++) {
                CreateQuad(side, offset, texture, textureIndex % texture.Length, indicesOffset, 
                           vertices, indices, ref verticesLocIndex, ref indicesLocIndex );
                textureIndex += 4;
            }
            return vertices;
        }

        static int[] baseIndices = new[] { 0, 1, 3, 1, 2, 3 };
        protected static void CreateQuad(int face, Vector3 offset, Vector2[] texture, int textureOffset,
                                         int indicesOffset, VertexPositionNormalTexture[] vertices, int[] indices,
                                         ref int verticesLocIndex, ref int indicesLocIndex ) {
            for (int i = 0; i < 6; i++)
                indices[indicesLocIndex++] = baseIndices[i] + (face * 4) + indicesOffset;

            var unit = CubeMesh[face];
            var normal = CubeNormals[face];
            for (int i = 0; i < 4; i++) {
                vertices[verticesLocIndex++] = new VertexPositionNormalTexture(offset + unit[i], normal, texture[textureOffset + i]);
            }
        }

In the Chunk class, you should consider using DateTime.UtcNow instead of DateTime.Now. Not only should this improve performance, this would also reduce memory usage as DateTime.Now allocates memory for parsing timezone info. (CLRProfiler indicates retrieving DateTime.Now when calling Chunk.GetBlockId from processing chunks ends up allocating 144 megabytes of memory)
See comment
Part 1 addresses the 1.5 gigabytes allocated in List.AddRange,
Part 2 addresses the 1.4 gigabytes in BlockRenderer.RenderBlock

Dockerfile

Automating builds would make TrueCraft more accessible. Mono has a docker image that automatically builds and runs projects.

Ex. Dockerfile (in project root):

FROM mono:4.0.0-onbuild
EXPOSE 25565
CMD [ "mono",  "./TrueCraft.exe" ]

Build with:

docker build -t truecraft .

or, if you want to tag the image with the git commit id:

TAG=`git log --format="%H" -n 1 | cut -c1-10`; docker build -t "truecraft:$TAG" .

Run with:

docker run -it --rm -p 25565:25565 truecraft

Terrain Generation
- Anything that requires looking at other chunks
- Overhangs/advanced terrain generation