mirror of
https://github.com/evennia/evennia.git
synced 2026-03-18 13:56:30 +01:00
58e20e2cf1
The system uses a hybrid blacklisting/whitelisting and AST-traversal approach to both remove dangerous builtins as well as disallow potentially exploitable python structures alltogether. Examples are while structures and attribute allocation. All advanced functionality is accessed through a set of "safe" methods on a holder object. You can extend this with your own safe methods in order to add more functionality befitting your game. The system comes with a host of examples, a few scriptable objects and complete commands for adding code to objects. At this point it's not guaranteed that all systems are safe against meddling however - notably Attributes have no locks defined on them by default (although this system does properly check Attribute lock types should they exixt). Please test and try to break - and report problems to the Issue tracker/forum as usual.
73 lines
2.4 KiB
Python
73 lines
2.4 KiB
Python
"""
|
|
|
|
Evlang - usage examples
|
|
|
|
Craftable object with matching command
|
|
|
|
Evennia contribution - Griatch 2012
|
|
|
|
"""
|
|
|
|
from ev import create_object
|
|
from ev import default_cmds
|
|
from contrib.evlang.objects import ScriptableObject
|
|
|
|
#------------------------------------------------------------
|
|
# Example for creating a scriptable object with a custom
|
|
# "crafting" command that sets coding restrictions on the
|
|
# object.
|
|
#------------------------------------------------------------
|
|
|
|
class CmdCraftScriptable(default_cmds.MuxCommand):
|
|
"""
|
|
craft a scriptable object
|
|
|
|
Usage:
|
|
@craftscriptable <name>
|
|
|
|
"""
|
|
key = "@craftscriptable"
|
|
locks = "cmd:perm(Builder)"
|
|
help_category = "Building"
|
|
|
|
def func(self):
|
|
"Implements the command"
|
|
caller = self.caller
|
|
if not self.args:
|
|
caller.msg("Usage: @craftscriptable <name>")
|
|
return
|
|
objname = self.args.strip()
|
|
obj = create_object(CraftedScriptableObject, key=objname, location=caller.location)
|
|
if not obj:
|
|
caller.msg("There was an error creating %s!" % objname)
|
|
return
|
|
# set locks on the object restrictive coding only to us, the creator.
|
|
obj.db.evlang_locks = {"get":"code:id(%s) or perm(Wizards)" % caller.dbref,
|
|
"drop":"code:id(%s) or perm(Wizards)" % caller.dbref,
|
|
"look": "code:id(%s) or perm(Wizards)" % caller.dbref}
|
|
caller.msg("Crafted %s. Use @desc and @code to customize it." % objname)
|
|
|
|
|
|
class CraftedScriptableObject(ScriptableObject):
|
|
"""
|
|
An object which allows customization of what happens when it is
|
|
dropped, taken or examined. It is meant to be created with the
|
|
special command CmdCraftScriptable above, for example as part of
|
|
an in-game "crafting" operation. It can henceforth be expanded
|
|
with custom scripting with the @code command (and only the crafter
|
|
(and Wizards) will be able to do so).
|
|
|
|
Allowed Evlang scripts:
|
|
"get"
|
|
"drop"
|
|
"look"
|
|
"""
|
|
def at_get(self, getter):
|
|
"called when object is picked up"
|
|
self.ndb.evlang.run_by_name("get", getter)
|
|
def at_drop(self, dropper):
|
|
"called when object is dropped"
|
|
self.ndb.evlang.run_by_name("drop", dropper)
|
|
def at_desc(self, looker):
|
|
"called when object is being looked at."
|
|
self.ndb.evlang.run_by_name("look", looker)
|