[1.13-1.19]Minecraft-Python —— 支持Python脚本插件

Jython目前只支持Python 2，而且似乎它会持续很长一段时间。
有各种Python 3 <-> JVM互操作项目可用，尽管这些项目似乎都没有像Jython那样在JVM实现上提供完整的Python的易用性。


Py4j很接近，早期的提交确实提供了一种使用此库与Minecraft交互的方法。

然而，Py4J实现严重依赖Python和JVM之间的回调，这些回调通过网络发送。

将此与许多线程杂耍和Spigt的内部线程模型相结合是令人生畏的。

该实现有效，但在尝试在Spigot服务器上执行大量操作时非常不稳定，所以我最终暂时将其从代码库中删除。

我（原作者）稍后可能会把这个重新添加到一个单独的分支中。

# Import some modules
from mcapi import *
from time import sleep
from random import randint

MY_NAME = "Macuyiko"

# Note: all code runs asynchronously by default. If you want to make world edits, Spigot
# forces you to execute these on a synchronised task. Most of the methods included in mcapi
# will take care of this automatically

# Set the time to sundawn
time(0)

# Zap the point where I'm looking at
bolt(lookingat(player(MY_NAME)))

# A small explosion instead
explosion(lookingat(player(MY_NAME)), power=2)

# Generate a tree (only works if there is room)
tree(lookingat(player(MY_NAME)))

# Spawn some particles
particle(lookingat(player(MY_NAME)))

# Spawn an entity (chicken by default)
spawn(lookingat(player(MY_NAME)))

# Fireworks
fireworks(lookingat(player(MY_NAME)))

# Let's create an exploding chicken spell

def exploding_chicken(player_name):
    yell("Creating an exploding chicken")
    chicken = spawn(lookingat(player(player_name)))
    for i in range(5,0,-1):
        yell("%s second(s) left..." % i)
        sleep(1)
    explosion(location(chicken), power=2)
        
        
# Try it!
exploding_chicken(MY_NAME)

# Now let's define a command for this spell
# Command functions take a special form func(caller, params)

@asynchronous()
def cmd_explode_spell(caller, params):
        exploding_chicken(caller.getName())

# Commands are executed synchronously by Spigot
# This means that all actions in exploding_chicken would use the state of the
# world as it was at the current server tick when executing the command,
# hence, we use the @asynchronous() decorator to force this function to be
# ran asynchronously, only synchronising every time a synchronous command is called

add_command('chickenspell', cmd_explode_spell)

# Try typing `/chickenspell` in Minecraft chat window
# Commands can be unregistered using
remove_command('chickenspell')

# Let's register another command to show of the asynchronous workings

@asynchronous()
def cmd_growme(caller, params):
    beginning = lookingat(player(caller.getName()))
    position = [beginning.x, beginning.y, beginning.z]
    for i in range(100):
        setblock(position) # <- will be synchronised
        position[randint(0,2)] += randint(-1,1)
        position[1] += +1
        sleep(0.05)

add_command('growme', cmd_growme)

# Now let's register an event
# These need a func(event) definition

from org.bukkit.event.block import BlockDamageEvent

# Almost all events execute synchronised, so again we force them to be asynchronous

@asynchronous()
def damage_evt(e):
    player = e.getPlayer()
    position = location(player)
    yell("I'll count to ten, get out!")
    for i in range(10):
        yell(str(i))
        sleep(1.0)
    explosion(position)

# A block will explode if the player damages it
listener = add_event_listener(BlockDamageEvent, damage_evt)

# Remove specific event hook
remove_event_listener(listener)

# Or all hooks
remove_event_listeners()

from mcapi import *
from time import sleep
from random import randint

from org.bukkit.event.player import PlayerJoinEvent

@asynchronous()
def join_event(e):
    player = e.getPlayer()
    player_location = location(player)
    player_location.y += 20
    yell("A chickeny hello to player %s" % (player.getName(),))
    for i in range(10):
        spawn(player_location)

listener = add_event_listener(PlayerJoinEvent, join_event)