Support Version 1.14

.gitignore

@@ -1,5 +1,4 @@
 ### Java template
-target/
 
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
@@ -28,7 +27,7 @@ hs_err_pid*
 *.iws
 
 # IntelliJ
-/out/
+#/out/
 
 # JIRA plugin
 atlassian-ide-plugin.xml
@@ -56,6 +55,9 @@ tmp/
 
 # Editor detritus
 *.vim
-*.swp
+#*.swp
 tags
-.vscode
+.vscode
+.idea/encodings.xml
+.idea/modules.xml
+#target/

README.md

@@ -1,63 +1,183 @@
 # RaspberryJuice
 
-A Bukkit plugin which implements the Minecraft Pi Socket API.
+A Minecraft Bukkit plugin which connect to python program
 
 ## Commands
 
 ### Commands supported
 
- - world.get/setBlock
- - world.getBlockWithData
- - world.setBlocks
- - world.getPlayerIds
- - world.getBlocks
- - chat.post
- - events.clear
- - events.block.hits
- - player.getTile
- - player.setTile
- - player.getPos
- - player.setPos
- - world.getHeight
- - entity.getTile
- - entity.setTile
- - entity.getPos
- - entity.setPos
+#### world
+ - world.getBlock(x:int, y:int, z:int) -> str
+   - Get the block of the input position
+
+
+ - world.getBlocks(x1:int, y1:int, z1:int, x2:int, y2:int, z2:int) -> list
+   - Get the blocks of the input position range
+
+
+ - world.setBlock(x:int, y:int, z:int, block:str) -> None:
+   - Set the block of the input position
+
+
+ - world.setBlocks(x1:int, y1:int, z1:int, x2:int, y2:int, z2:int, block) -> None:
+    - Set the blocks of the input position range
+
+
+ - world.getHeight(x:int, z:int) -> int:
+    - Get highest position y of the block
+
+
+ - world.getPlayerEntityIds() -> list:
+    - Get the list of server players'id
+
+
+ - world.postToChat(*msg) -> None:
+    -Print message to minecraft chat
+
+
+ - world.setSign(x:int, y:int, z:int, signType:str, signDir:int, line1:str="", line2:str="", line3:str="", line4:str="") -> None:
+    - Set the stand sign of the input position
+
+
+ - world.setWallSign(x:int, y:int, z:int, signType:str, signDir:int, line1="",line2="",line3="",line4="") -> None:
+    - Set the wall sign of the input position
+
+
+ - world.spawnEntity(x:int, y:int, z:int, entityID:int) -> int:
+    - Spawn a entity of the input position
+
+
+ - world.createExplosion(x:int, y:int, z:int, power:int=4) -> None:
+    - Create a explosion of the input position
+
+
+ - world.getPlayerEntityId(name:str) -> int:
+    - Get the entity ID of input name
+
+
+ - world.create(address = "localhost", port = 4711):
+    - Connect your python program to Raspberryjuice
+
+
+ ---
+
+#### player
+ - player.getPos() -> Vec3:
+    - Get player's float position
+
+
+ - player.setPos(x:float, y:float, z:float) -> None:
+    - Set player's position with float
+
+
+ - player.getTilePos() -> Vec3:
+    - Get player's integer position
+
+ - player.setTilePos(x:int, y:int, z:int) -> None:
+    -Set player's integer position
+
+
+ - player.getDirection() -> Vec3:
+    - Get player's direction
+
+
+ - player.setDirection(x:float, y:float, z:float) -> None:
+    - Set player's direction
+
+
+ - player.getRotation() -> float:
+    - Get player's rotation
+
+
+ - player.setRotation(yaw:float) -> None:
+    - Set player's rotation
+
+
+ - player.getPitch() -> float:
+    - Get player's pitch
+
+
+ - player.setPitch(pitch) -> None:
+     - Set player's pitch
+
+
+ - player.getFoodLevel() -> int:
+    - Get player's food level
+
+
+- player.setFoodLevel(foodLevel:int) -> None:
+    - Set player's food level
+
+
+- player.getHealth() -> float:
+    - Get player's health
+
+
+- player.setHealth(health:float) -> None:
+    - Set player's health
+
+
+ - player.sendTitle(title:str, subTitle:str="", fadeIn:int=10, stay:int=70, fadeOut:int=20) -> None:
+    - Send a title to player
+
+ ---
+
+#### entity
+ - entity.getPos(ID) -> Vec3:
+    - Get specific entity's float position
+
+
+ - entity.setPos(ID, x:float, y:float, z:float) -> None:
+    - Set specific entity's position with float
+
+
+ - entity.getTilePos(ID) -> Vec3:
+    - Get specific entity's integer position
+
+
+ - entity.setTilePos(ID, x:int, y:int, z:int) -> None:
+    - Set specific entity's position with integer
+
+
+ - entity.getDirection(ID) -> Vec3:
+    - Get specific entity's direction
+
+
+ - entity.setDirection(ID, x:float, y:float, z:float) -> None:
+    - Set specific entity's direction
+
+
+ - entity.getRotation(ID) -> float:
+    - Get specific entity's rotation
+
+
+ - entity.setRotation(ID, yaw) -> float:
+    - Set specific entity's rotation
+
+
+ - entity.getPitch(ID) -> float:
+    - Get specific entity's pitch
+
+
+ - entity.setPitch(ID, pitch) -> None:
+    - Set specific entity's pitch
+
+
+ - entity.getName(ID):
+    -  Get specific entity's name
 
 ### Commands that can't be supported
 
  - Camera angles
-
-### Extra commands
-
- - getBlocks(x1,y1,z1,x2,y2,z2) has been implemented
- - getDirection, getRotation, getPitch functions - get the 'direction' players and entities are facing
- - setDirection, setRotation, setPitch functions - set the 'direction' players and entities are facing
- - getPlayerId(playerName) - get the entity of a player by name
- - pollChatPosts() - get events back for posts to the chat
- - setSign(x,y,z,block type id,data,line1,line2,line3,line4)
-   - Wall signs (id=68 or block.SIGN_WALL.id) require data for facing direction 2=north, 3=south, 4=west, 5=east
-   - Standing signs (id=63 or block.SIGN_STANDING.id) require data for facing rotation (0-15) 0=south, 4=west, 8=north, 12=east
- - spawnEntity(x,y,z,entity) - creates an entity and returns its entity id. see entity.py for list.
- - getEntityTypes - returns all the entities supported by the server.
- - entity.getName(id) - get a player name for entity id. Reverse of getPlayerId(playerName)
-
-Note - extra features are NOT guaranteed to be maintained in future releases, particularly if updates are made to the original Pi API which replace the functionality
-
+
 ## Config
 
 Modify config.yml:
 
  - port: 4711 - the default tcp port can be changed in config.yml
- - location: RELATIVE - determine whether locations are RELATIVE to the spawn point (default like pi) or ABSOLUTE
+ - location: ABSOLUTE - determine whether locations are RELATIVE to the spawn point or ABSOLUTE
  - hitclick: RIGHT - determine whether hit events are triggered by LEFT clicks, RIGHT clicks or BOTH 
 
-## Libraries
-
-To use the extra features an modded version of the java and python libraries that were originally supplied by Mojang with the Pi is required, [github.com/zhuowei/RaspberryJuice/tree/master/src/main/resources/mcpi](https://github.com/zhuowei/RaspberryJuice/tree/master/src/main/resources/mcpi).  
-
-You only need the modded libraries to use the extra features, the original libraries supplied with Minecraft Pi edition still work, you just wont be able to use the extra features
-
 ## Build
 
 To build RaspberryJuice, [download and install Maven](https://maven.apache.org/install.html), clone the repository, run `mvn package':
@@ -70,6 +190,7 @@ mvn package
 
 ## Version history
 
+ - 1.14 - Modify the command, change the block number identity to block name.
  - 1.11 - spawnEntity, setDirection, setRotation, setPitch
  - 1.10.1 - bug fixes
  - 1.10 - left, right, both hit clicks added to config.yml & fixed minor hit events bug

out/example/ChickenFly.py

@@ -0,0 +1,21 @@
+from mcpi.minecraft import Minecraft
+mc = Minecraft.create()
+
+import random, time
+
+# Get player position
+x,y,z = mc.player.getPos()
+
+# Spawn a chicken on player's position,and record the chicken's entity id
+chicken = mc.spawnEntity(x, y, z, 93)
+
+for i in range(30):
+    # Get player position
+    x,y,z = mc.player.getPos()
+    # Add a random number on x and z position
+    x += random.uniform(-3, 3)
+    z += random.uniform(-3, 3)
+    # Teleport chicken
+    mc.entity.setPos(chicken, x, y+3, z)
+    # Sleep 0.5 seconds
+    time.sleep(0.5)

out/example/SwordExplode.py

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+"""
+Created on Tue Oct  1 21:31:06 2019
+
+@author: Eric
+"""
+
+from mcpi.minecraft import Minecraft
+mc = Minecraft.create()
+
+while True:
+    # Get list of events
+    hitBlocks = mc.events.pollBlockHits()
+    # If events not None
+    if hitBlocks:
+        # Get the first event
+        hitBlock = hitBlocks[0]
+        # Get the event position
+        x,y,z = hitBlock.pos
+        # Create a explosion on the position
+        mc.createExplosion(x, y, z)

out/example/example1.py

@@ -0,0 +1,6 @@
+from mcpi.minecraft import Minecraft
+mc = Minecraft.create()
+
+x,y,z = mc.player.getTilePos()
+
+mc.createExplosion(x,y,z)

out/example/randomTeleport.py

@@ -0,0 +1,12 @@
+from mcpi.minecraft import Minecraft
+mc = Minecraft.create()
+
+import random
+
+# Random position
+x = random.randrange(-1000, 1000)
+z = random.randrange(-1000, 1000)
+y = mc.getHeight(x, z)
+
+# Teleport player
+mc.player.setTilePos(x, y, z)