Denizen

Denizen

Meta Documentation | Issue Tracker | Script Repository | Tutorial Videos

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Denizen uses a pasting service provided by its developers to enable recording of debug sessions. This allows an easy and universal way to troubleshoot a script. It is only used on '/denizen submit', however this service is not endorsed by the BukkitDev staff. Use it at your own risk.

IRC channel | Source code | Development builds

About

Hey there! Thanks for using Denizen for Bukkit and Citizens2. Looking for a quick starting guide? Here's the place!

So, what is Denizen? It's is best classified as a scripting platform. Denizen for Bukkit and Citizens2 utilizes the scripting, and various other components provided by DenizenAPI. The scripting component of Denizen features easy to use script containers, replaceable tags, commands, and a queue system. Built aside is a slew of components that deal with many kinds of event handlers, many additional NPC features, a fully-featured variable system (we call them 'flags'), and a rich object-oriented set of features. I encourage users to start small when first getting into Denizen, but rest assured there are tons of features to explore.

Denizen NPCs? Yep, that's right. Denizen is probably best known as a way to create scripted Citizen NPCs. In fact, this whole project started out as an extension to Citizens2. You can use it to make interactive NPCs with the use of Assignment Scripts and Interact Scripts. This is pretty easy to do, and there's a bunch of cool NPC specific (among many other) commands and tags that you can utilize as well.

Here's a small example I call 'cookies'. I normally like to comment my scripts, but this one below is presented without any as to show the flow.

Cookies:
  type: assignment 
  interact scripts: 
  - 100 Cookie Handler 

Cookie Handler:
  type: interact 
  steps: 
    'Spreading the Word*': 
      click trigger: 
        script: 
        - random 3 
        - chat 'I like cookies!' 
        - chat 'MMmm.. cookies are favorite!' 
        - chat 'Cocoa and wheat me freak!' 
      chat trigger: 
        'Cookies': 
          trigger: 'I love /cookie/s!' 
          script:  
          - chat 'Me too!' 
          - narrate '<npc.name> gives you some cookies.' 
          - give i@cookie qty:6 
          - zap 'step:Cookies given' 
    'Cookies given': 
        click trigger: 
            script: 
            - chat 'How were the cookies?' 
            - zap 'step:Spreading the Word'

It's a simple 2-step, multi-trigger script that creates a cookie loving NPC. For some reason I think it's funny to name the NPC 'Notch'. Making a NPC use this script couldn't be easier, either. Simply use a bukkit command while having the NPC selected. It looks like this:

/npc assignment --set cookies

Now clicking on your NPC will use Denizen Triggers to activate the script above. An instant Denizen NPC! Cookies is funny, but hardly useful, and it's my personal philosophy that NPCs should be useful. How 'bout a simple healer? This NPC will heal you, but only when you're seriously injured.

Basic Healer: 
  type: assignment 
  interact scripts: 
  - 100 heal me, bro! 

Heal me, bro!: 
  type: interact 
  steps: 
    "Need a heal?*": 
      click trigger: 
        script: 
        - if '<player.health>' < '<m:<player.health.max> / 2>' { 
            - look <player.location> 
            - chat 'Woah dude, you are <player.health.formatted>! You could use a heal!' 
            - chat 'Just give me another click to get some power!' 
            - zap "Healin'" duration:30s 
          } else { 
            - look <player.location> 
            - chat 'Nice an healthy. Keep it up!'  
          } 
    "Healin'": 
      click trigger: 
        script: 
        - ^zap 'need a heal?' 
        - ^engage 
        - chat "Here goes nothin'!" 
        - playeffect instant_spell <npc.location> qty:25 
        - playeffect heart <player.location> qty:25 offset:1 
        - heal <player> 
        - disengage

How do you make a Healer NPC with this script? You guess it! Just select that NPC, and type:

/npc assignment --set 'basic healer'

It's not just for NPCs. I guess I already told you that, but Denizen has some other script types that open up possibilities that extend far beyond it's core functionality of utilizing NPCs. One of my favorite 'simple scripts' that I like to show people is one that my friend Blankiito showed me. The one below is slightly modified, but basically it enables a 'rogue-like feature' that makes a player invisible when sneaking. It's a simple concept, but perfectly illustrates the flow of a Denizen Script.

Rogue: 
  type: world 
  debug: false 
  events: 
    on player starts sneaking: 
    - playeffect <p.location> magic_crit qty:10 
    - invisible <player> state:true 

    on player stops sneaking: 
    - invisible <player> state:false

Even small scripts can be incredibly useful for your server. Sometimes scripts can replace entire bukkit plugins, and since the 'code' is in Denizen Script, the end result is often times more flexible to you, the server operator. Have a plugin that run some commands every once in awhile? Replace it with a simple Denizen script.

Auto Save Event Handler: 
  type: world 
  debug: false 
  events: 
    on 5:00 in w@world:  
    - announce 'Autosaving...' 
    - execute as_server 'denizen save' 
    - execute as_server 'citizens save' 
    - execute as_server 'save-all'

Use Denizen to solve problems, or to make features easier to use. Example: If you're familiar with Citizens, you may have realized that WorldGuard's /butcher command is not friendly to mob-type NPCs. It removes them, too, which can be a pain! Why not write your own /butcher command?

Safer Butcher Handler: 
  type: world 
  debug: false 
  events: 
    on sbutcher command:  
    - narrate 'Removing all mob entities within 15 blocks... your NPCs are safe!'  
    - foreach <player.location.find.entities.within[15]> {  
        - if <%value%.is_mob>  
          remove %value%  
      }

Denizen Quests are the best quests. If you're like me, this whole thing started by using the Quester for Citizens1. It featured a fairly simple questing structure to implement things like 'kill quests' and 'collection quests'. When Citizens went to version 2, that functionality was no longer 'core', but no worries Denizen can help! By utilizing Denizen's Player Listeners, simple questing can be done easily, and it's more robust because you can use all the other features implemented by Denizen, too!

So, how do you best get started? This is a question we get all the time. Because of the enormous amount of ways to use and customize Denizen, we suggest that you simply START SMALL! Checking out the videos, scripts, and articles on denizen-docs you're sure to find a comfortable place to start. While scripting, utilize the tools provided, such as the SublimeText2 grammar pack, and the reference and search for meta lookup on this site.

Like any programming language, there is a learning curve with code structure and syntax that will only be overcome by trial and error. While using some user-made scripts can be as easy as dragging-and-dropping, many scripts will likely require at least a basic understanding of the denizen-script structure to fully utilize their features. But don't worry! Denizen is purposefully made to be easy to read and easy to customize! Tags, commands and events are all very verbose, easy to follow. With a little bit of research we know you'll soon be drunken with power, just like us!

Videos

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of mcmonkey4eva mcmonkey4eva Jul 30, 2014 at 19:57 UTC - 0 likes

    @Supersting: Go

    Update both Sentry and Denizen to latest dev builds ( http://ci.citizensnpcs.co/job/Sentry/ http://ci.citizensnpcs.co/job/Denizen/ ) + run CB 1.7.10

    That error is because of mismatched Sentry and Denizen versions, as well as the lack of a death action. The best fix is updating to 1.7.10 latest dev builds as I said above. Otherwise, explore the builds and find the latest 1.7.9 dev builds at least.

  • Avatar of Supersting Supersting Jul 30, 2014 at 19:50 UTC - 0 likes

    I need a script which makes a sentry npc drop extra items on death. The "on death" action doesn't seem to work (probably because using sentry disables the health trait). The Npcdeath trigger doesn't seem to work either as when I end it with the DIE command, I get this error (straight from console):

    30.07 19:31:24 [Server] WARN at net.minecraft.server.v1_7_R3.ThreadServerApplication.run(SourceFile:628) 30.07 19:31:24 [Server] WARN at net.minecraft.server.v1_7_R3.MinecraftServer.run(MinecraftServer.java:469) 30.07 19:31:24 [Server] WARN at net.minecraft.server.v1_7_R3.MinecraftServer.u(MinecraftServer.java:558) 30.07 19:31:24 [Server] WARN at net.minecraft.server.v1_7_R3.DedicatedServer.v(DedicatedServer.java:260) 30.07 19:31:24 [Server] WARN at net.minecraft.server.v1_7_R3.MinecraftServer.v(MinecraftServer.java:600) 30.07 19:31:24 [Server] WARN at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:345) 30.07 19:31:24 [Server] WARN at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftTask.run(CraftTask.java:53) 30.07 19:31:24 [Server] WARN at net.aufdemrand.denizen.scripts.queues.core.TimedQueue$1.run(TimedQueue.java:154) 30.07 19:31:24 [Server] WARN at net.aufdemrand.denizen.scripts.queues.core.TimedQueue.access$000(TimedQueue.java:11) 30.07 19:31:24 [Server] WARN at net.aufdemrand.denizen.scripts.queues.ScriptQueue.revolve(ScriptQueue.java:580) 30.07 19:31:24 [Server] WARN at net.aufdemrand.denizen.scripts.queues.ScriptEngine.revolve(ScriptEngine.java:53) 30.07 19:31:24 [Server] WARN at net.aufdemrand.denizen.scripts.commands.CommandExecuter.execute(CommandExecuter.java:193) 30.07 19:31:24 [Server] WARN at net.aufdemrand.sentry.DenizenHook$DieCommand.execute(DenizenHook.java:125) 30.07 19:31:24 [Server] WARN at net.aufdemrand.sentry.SentryInstance.die(SentryInstance.java:491) 30.07 19:31:24 [Server] WARN at net.aufdemrand.sentry.DenizenHook.DenizenAction(DenizenHook.java:70) 30.07 19:31:24 [Server] WARN java.lang.NoSuchMethodError: net.aufdemrand.denizen.objects.dNPC.action(Ljava/lang/String;Lnet/aufdemrand/denizen/objects/dPlayer;)V 30.07 19:31:24 [Server] INFO command! 30.07 19:31:24 [Server] INFO ERROR! Woah! An exception has been called with this 30.07 19:31:24 [Server] INFO +> [DieCommand] Goodbye, cruel world... 30.07 19:31:24 [Server] INFO +- Executing dCommand: DIE/p@Supersting -+

  • Avatar of mcmonkey4eva mcmonkey4eva Jul 28, 2014 at 00:58 UTC - 0 likes

    @Mexbotdude: Go

    Update Citizens, that's from when Citizens tried to look up all the NPC skins at once, which Mojang dislikes now.

  • Avatar of Mexbotdude Mexbotdude Jul 27, 2014 at 21:21 UTC - 0 likes

    any idea about this?

    [16:18:19 WARN]: Couldn't look up profile properties for net.minecraft.util.com.mojang.authlib.GameProfile@35e60d1e[id=5683c55d-986d-4e05-ac0e-fb41d730d286,name=,properties={},legacy=false] net.minecraft.util.com.mojang.authlib.exceptions.AuthenticationException: The client has sent too many requests within a certain amount of time at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilAuthenticationService.makeRequest(YggdrasilAuthenticationService.java:65) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilMinecraftSessionService.fillProfileProperties(YggdrasilMinecraftSessionService.java:135) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.citizensnpcs.npc.entity.HumanController$SkinFetcher.run(HumanController.java:117) [citizens-2.0.13-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftTask.run(CraftTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145) [?:1.7.0_51] at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615) [?:1.7.0_51] at java.lang.Thread.run(Thread.java:744) [?:1.7.0_51] [16:18:19 INFO]: [ProtocolLib] The updater found an update, but because of the UpdateType being set to NO_DOWNLOAD, it wasn't downloaded. [16:18:19 WARN]: Couldn't look up profile properties for net.minecraft.util.com.mojang.authlib.GameProfile@743c2fb4[id=0fc345e8-a4c1-4897-880b-734f8fe3826d,name=,properties={},legacy=false] net.minecraft.util.com.mojang.authlib.exceptions.AuthenticationException: The client has sent too many requests within a certain amount of time at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilAuthenticationService.makeRequest(YggdrasilAuthenticationService.java:65) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilMinecraftSessionService.fillProfileProperties(YggdrasilMinecraftSessionService.java:135) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.citizensnpcs.npc.entity.HumanController$SkinFetcher.run(HumanController.java:117) [citizens-2.0.13-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftTask.run(CraftTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145) [?:1.7.0_51] at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615) [?:1.7.0_51] at java.lang.Thread.run(Thread.java:744) [?:1.7.0_51] [16:18:20 WARN]: Couldn't look up profile properties for net.minecraft.util.com.mojang.authlib.GameProfile@38c8da51[id=a6396dc5-e4e6-4b8d-b916-d5480044cf2d,name=,properties={},legacy=false] net.minecraft.util.com.mojang.authlib.exceptions.AuthenticationException: The client has sent too many requests within a certain amount of time at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilAuthenticationService.makeRequest(YggdrasilAuthenticationService.java:65) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilMinecraftSessionService.fillProfileProperties(YggdrasilMinecraftSessionService.java:135) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.citizensnpcs.npc.entity.HumanController$SkinFetcher.run(HumanController.java:117) [citizens-2.0.13-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftTask.run(CraftTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145) [?:1.7.0_51] at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615) [?:1.7.0_51] at java.lang.Thread.run(Thread.java:744) [?:1.7.0_51] [16:18:20 WARN]: Couldn't look up profile properties for net.minecraft.util.com.mojang.authlib.GameProfile@a7ff1a1[id=9e27bc29-7d83-4e5c-8ae5-9223e0014ef2,name=,properties={},legacy=false] net.minecraft.util.com.mojang.authlib.exceptions.AuthenticationException: The client has sent too many requests within a certain amount of time at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilAuthenticationService.makeRequest(YggdrasilAuthenticationService.java:65) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilMinecraftSessionService.fillProfileProperties(YggdrasilMinecraftSessionService.java:135) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.citizensnpcs.npc.entity.HumanController$SkinFetcher.run(HumanController.java:117) [citizens-2.0.13-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftTask.run(CraftTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145) [?:1.7.0_51] at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615) [?:1.7.0_51] at java.lang.Thread.run(Thread.java:744) [?:1.7.0_51] [16:18:20 WARN]: Couldn't look up profile properties for net.minecraft.util.com.mojang.authlib.GameProfile@6d288382[id=acc2d6e0-58ad-4c26-9b8b-4273606f4515,name=,properties={},legacy=false] net.minecraft.util.com.mojang.authlib.exceptions.AuthenticationException: The client has sent too many requests within a certain amount of time at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilAuthenticationService.makeRequest(YggdrasilAuthenticationService.java:65) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.minecraft.util.com.mojang.authlib.yggdrasil.YggdrasilMinecraftSessionService.fillProfileProperties(YggdrasilMinecraftSessionService.java:135) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at net.citizensnpcs.npc.entity.HumanController$SkinFetcher.run(HumanController.java:117) [citizens-2.0.13-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftTask.run(CraftTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.9-R0.2-11-g3fd9db2-b3098jnks] at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145) [?:1.7.0_51] at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615) [?:1.7.0_51] at java.lang.Thread.run(Thread.java:744) [?:1.7.0_51] [16:18:44 WARN]: Can't keep up! Did the system time change, or is the server overloaded? Running 3039ms behind, skipping 60 tick(s)

  • Avatar of mcmonkey4eva mcmonkey4eva Jul 15, 2014 at 03:04 UTC - 0 likes

    @XLighterShadowX: Go

    That's a CB/Denizen incompatibility issue. Use a more up-to-date CraftBukkit version. You're on 1.7.9, so the very latest 1.7.9 dev build.

    (Or better yet, use 1.7.10, and just latest everything)

  • Avatar of XLighterShadowX XLighterShadowX Jul 15, 2014 at 00:51 UTC - 0 likes

    Finally going through and converting my upcoming server to 1.7.# and as you can imagine it's pretty tedious. However I'm having this problem I can't seem to figure out when using a proximity trigger (on assignment: - trigger name:proximity state:true radius:5)

    [01:38:49] [Server thread/WARN]: [Denizen] Task #32 for Denizen v0.9.4-SNAPSHOT (build 1483) generated an exception
    java.lang.NoSuchMethodError: org.bukkit.Bukkit.getOnlinePlayers()Ljava/util/Collection;
    	at net.aufdemrand.denizen.scripts.triggers.core.ProximityTrigger$1.run(ProximityTrigger.java:187) ~[?:?]
    	at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftTask.run(CraftTask.java:53) ~[craftbukkit.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
    	at org.bukkit.craftbukkit.v1_7_R3.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:345) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
    	at net.minecraft.server.v1_7_R3.MinecraftServer.v(MinecraftServer.java:600) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
    	at net.minecraft.server.v1_7_R3.DedicatedServer.v(DedicatedServer.java:260) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
    	at net.minecraft.server.v1_7_R3.MinecraftServer.u(MinecraftServer.java:558) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
    	at net.minecraft.server.v1_7_R3.MinecraftServer.run(MinecraftServer.java:469) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
    	at net.minecraft.server.v1_7_R3.ThreadServerApplication.run(SourceFile:628) [craftbukkit.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
    

    (plenty of console spam) CB: 1.7.9 R0.2 Denizens: 0.7.4 (1483)

    Famous Plugin Director 2010-2012 (worked with 125+ servers, 60+ successful)

    Making a comeback in 2015 with my own huge project.

  • Avatar of mcmonkey4eva mcmonkey4eva Jul 14, 2014 at 18:06 UTC - 0 likes

    @joda17: Go

    @AdamMario6556: Go

    You're running a 1.7.10 plugin version on a 1.7.9 server - either update your CraftBukkit to 1.7.10, or downdate your Denizen to the last 0.9.4 build.

  • Avatar of AdamMario6556 AdamMario6556 Jul 14, 2014 at 17:40 UTC - 0 likes

    im having the same issue as joda17, please help soon

  • Avatar of joda17 joda17 Jul 14, 2014 at 17:34 UTC - 0 likes
    Last edited Jul 14, 2014 by joda17
  • Avatar of mcmonkey4eva mcmonkey4eva Jul 13, 2014 at 20:58 UTC - 0 likes

    @Romanovski: Go

    Actually, if you were running the latest dev build, a major bug was discovered that could potentially be related. If so, updating to the latest dev build might fix it. If not, see previous reply.

Facts

Date created
May 21, 2012
Categories
Last update
Jul 16, 2014
Development stage
Beta
Language
  • enUS
License
GNU General Public License version 3 (GPLv3)
Curse link
Denizen
Downloads
34,914
Recent files

Authors