[PCD]Denizen新手教程之一：使用前必读

本帖最后由秋风残叶于 2021-7-18 17:59 编辑

Denizen新手教程

Denizen Beginner's Guide

译者按

Denizen是一款功能非常强大的脚本引擎类型的服务端插件，如果您对Denizen还不了解请参考这个站内搬运帖。
Denizen虽然功能强大，但学习起来较为复杂，无编程基础的新人想要入门总是十分不易。在以前，Denizen只提供了用来查阅变量/脚本的参考文档，甚至连个入门教程都没有，这更让新手入门雪上加霜。
本插件的搬运者在摸索了插件脚本的基本用法，并在搬运帖中写了少量教程，写的十分外行且不系统，但就算是这样的内容也确实帮助了一些服主，帮助他们燃起对Denizen脚本的兴趣，搬运者十分感谢他们的支持。
现在，想必作者团队也发现了插件入门不易的问题，现改版了旧版的 Denizenscript论坛并逐步推出了浅显易懂的入门教程，Denizen的搬运者立刻着手于本教程的翻译工作，现发布本译文。

秋风残叶

本教程总共9个大章节，您现在阅读的是第1大章节

使用前必读

Background

原文链接

此部分内容将介绍什么是Denizen，以及介绍一下Denizen能做啥。

如果您已经知道它能做啥了，想直接开始学写脚本，请直接转至“迈出第一步”部分。

Denizen是啥？
Denizen到底能做啥？
Denizen和Citizens能做出什么？
那么，在哪里可以下载到呢？
新人常见问题

Denizen是啥？

原文链接

Denizen是啥？

能稍微正经一点介绍一下吗？

Denizen的脚本实际上由YAML语法写成，相对于服主来说比较熟悉以及易用——不会吧不会吧不会有服主没编辑过YAML语法写的config文件吧？想象一下：写插件就跟编辑配置文件config一样简单，你想写啥就写啥！

实际说来，脚本的写法包含了两个方面：指令-变量（command-tag）

指令（command） ：没错，我所说的指令就是各位服主老爷天天在用的那个“指令”，比如/gamemode creative 或者/tp player 我们的Denizen的指令和上面那些指令是一个意思，只不过用横杠“-”代替了斜杠“/”

变量（tag） ：所谓的“变量”由一系列各位熟悉的内容组合而成，我想各位在读某些插件的指令列表的时候肯定见过这种指令/tp <player> 这条指令在使用的时候需要把实际玩家名称填写进变量框中。同理，Denizen的“变量（tag）”也是一种“指令执行时需要被填入”的内容，如果你在Denizen指令中写入了变量<player>，实际执行时系统也会将其替换为玩家名称，这个伟大的机制可以让简简单单的指令实现出强大的非凡的效果。（译者注：一大段文字都在扯一些有的没的……）

Denizen脚本长啥样啊？

所以这玩意跟编程是一样一样的咯？

也就是说，Denizen好学又好用……那么……

Denizen到底能做啥？

原文链接

简而言之

大佬用户能用它做啥？

这个问题……只要潜心钻研，万物尽在你手。

比如这个，这是一个区域保护脚本，能和WorldGuard一较高下： Spigot - dRegions

这个脚本只有20行，只要玩家把它拿在手上，等于拥有了一个移动光源： Forums - Denizen Torch Light

很久以前作者（mcmonkey）创作了Sentinel，现在用Denizen脚本可以做出一样的功能： Old Repo Archive - dSentry

或者一些不明觉厉的玩意儿，比如这个GUI展示的是一个密码输入界面。

小白用户能用它做啥？

这个问题……哪怕你很小白，还是有很多事可以实现！

用Denizen写一些添加服务器功能的脚本极为简单，比如这个每日自动重启服务器的脚本，只需几行代码就完成了

daily_autorestart:
type: world
debug: false
events:
on system time 01:00:
- announce "<gold>服务器将在10分钟内重启！"
- wait 5m
- announce "<gold>服务器将在5分钟内重启！"
- wait 2m
- announce "<gold>服务器将在3分钟内重启！"
- wait 1m
- announce "<gold>服务器将在2分钟内重启！"
- wait 1m
- announce "<gold>服务器将在1分钟内重启！"
- wait 30s
- announce "<gold>服务器将在30秒内重启！"
- wait 30s
- adjust server restart

复制代码

就是这么简单！大部分内容都只需复制粘贴即可！

用Denizen写任务也非常常见（通常可与NPC挂钩，请参阅： Denizen和Citizen能做出什么？）
自定义物品系统也很热门，你可以用类似如下脚本制作出自定义物品。

hero_sword:
type: item
debug: false
material: diamond_sword
display name: <gold>英雄之剑
lore:
- 只有英雄才能拥有这把剑
enchantments:
- sharpness:5

复制代码

想获得这个物品，直接使用Denizen指令- give 即可，或者也可以在world类型脚本中调用这件物品。

Denizen和Citizens能做出什么？

原文链接

两种方法搭配使用

RPG风格任务

NPC对话

过场动画

特殊

那么，在哪里可以下载到呢？

原文链接

前提条件

稳定版还是开发版？

讲了多少次了！不要在Spigot下载！

新人常见问题

原文链接

新人常见问题

以下将会列出一些新人常见问题。

自学写脚本太麻烦了，你直接帮我写一个得了！

老话说得好：授人以鱼不如授人以渔。
我们当然可以给你写一个脚本，但是你贪得无厌今天要一个明天又要一个怎么办？
我在这里教你怎么写脚本，以后你就永远可以自己想写啥就写啥，不要老靠别人，要靠你自己嗷！

听起来好难学啊！

如果你觉得Denizen听起来很难学……那我问你：开服难不难？我不信以编辑配置文件为核心的Denizen能比开服难到哪去（毕竟编辑配置文件是每个服主都会的）
这篇教程面向的人群就是Denizen新人以及小白，可以让你学会新本领，零基础也可以学。

我笨的很！估计学不会！

这话我们在Discord里听得耳朵都起茧子了。
有一个简单的道理：很多人坚信自己学不会，也从来不去尝试，既然不去尝试，自然也不可能学会。如果勇于做个尝试，最后能达到的程度绝对比一开始预想的高
想要学习Denizen，你只需要一个想学的信念外加一点精力和时间去尝试而已。

那我偏偏没有时间，咋办？

首先：如果你每周能挤出几个小时，我相信这就够了，你绝对可以学会Denizen的基础用法。
这也做不到？你tm开过服吗？开服所花费的时间比这多多了好吧？
如果你还是觉得没时间，可以考虑雇佣一位脚本师（scripter）
如果你没时间是因为已经花了大把时间在运营服务器上了，可以考虑让你的朋友/服管等等你周围的人来学，Denizen人人可学，你只需找一位愿意花时间和精力在上面的人学就行了，学好了再给你的服务器打工。

有关这篇指南

写的太长，我能跳过指南不读吗？
最好不要，这是一篇初学者指南，不是参考文档，它教你一步步熟悉这个插件，要是你跳过了那我岂不白写了吗？如果你已经读完了“迈出第一步”和“基础篇”，这时候你再打开参考文档查找内容写脚本，才算比较合适。

那我需要一个字不漏地读完这篇指南吗？
不至于不至于，这也就是一篇指南而已，不是一本大书，它只是为了告诉你接下来要怎么做而已，强行一个字一个字读只会左耳进右耳出而已，啥也学不到。

那我接下来该怎么办？
按照指南所述一步一步来，指南让你做啥你就做啥（比如写一个范例脚本或者使用一个范例变量）打开你的脚本编辑器，然后大喊奥力给，写就完事了！然后再看看这脚本运行起来是啥效果，熟练运用自身所学，还可以举一反三，写的比教程里展示的内容更多！当你学会了一条新指令，你可以不断尝试这指令能玩出什么样的花来，还可以结合之前所学的旧知识，看看新旧内容结合能碰撞出怎样的火花，当你熟练运用这些知识之后，你就算出师了！今后你就可以活学活用，在服务器里玩出新花样了！

下一篇教程：迈出第一步（点击跳转）

来自群组: PluginsCDTribe

[PCD]Denizen新手教程之一：使用前必读

回复: