Commits

Anonymous committed 9df218a

disclaimer and example

  • Participants
  • Parent commits 8229e14

Comments (0)

Files changed (1)

       -h, --help     show this help message and exit
       -n, --no-gzip  Don't use gzip
 
+Example Use
+===========
+
+Suppose we want to switch the "GameMode" from "0" (survival) to "1"
+(creative).
+
+First, ensure that Minecraft itself is **not running**.  Then, navigate to 
+where your Minecraft save files are.  Here's how it looks on a mac::
+
+    $ cd ~/Library/Application\ Support/minecraft/saves/
+
+Once there, edit the ``level.dat`` file for any selected world::
+
+    nbtedit myworld/level.dat
+
+Assuming you have your EDITOR variable set, an editor like ``vim``, ``nano``, ``emacs``,
+or something else should pop up.   Window based editors can be used
+if they present a command line command that doesn't exit until the file is saved
+(such as, I can use ``mate -w`` here to use TextMate).
+
+Then navigate down to the "GameType" value::
+
+      - foodSaturationLevel: 0.0
+      - FallDistance: 0.0
+      - XpTotal: 0
+      - Rotation:
+        - -476.3782043457031
+        - 28.349964141845703
+      - Xp: 0
+    - RandomSeed: !long "1201953322384967445L"
+    - GameType: 0
+    - MapFeatures: !byte "0"
+    - version: 19132
+    - Time: !long "5601373"
+    - raining: !byte "0"
+    - thunderTime: 19527
+
+Change it from "0" (survival) to "1" (creative)::
+
+    - RandomSeed: !long "1201953322384967445L"
+    - GameType: 1
+    - MapFeatures: !byte "0"
+
+Save the file.  ``nbtedit`` reports that it saved a copy of the old file and wrote
+the changes to the existing file.   Now you can build some castles !
+
 Format
 ======
 
         $N\x1E\\@.&(4J\x060"
     - doubleTest: !double "0.4931287132182315"
 
+Disclaimer
+==========
 
+nbtedit is **brand new**.   If it's September, 2011, you are one of the **first** people reading this
+README.   If there is a bug in nbtedit, you're about to be the person who finds it !
+
+**Back EVERYTHING up before tinkering with your files !!**  nbtedit saves a backup of each file it edits, but 
+**don't rely solely on that!**.  Please note you are **using this editor at your own risk**.   The code is
+unit tested, works great, but I'd hate to be the reason you screwed up your world so **make copies first**.
+
+