本帖最后由 berry64 于 2019-2-2 18:47 编辑







config.yml(带介绍的配置文件)

默认lang.yml(语言文件):

2021.12 数据，可能有更多内容

Referrals — 推荐插件
2019/2/2 插件进入1.0版本， 该版本更新了玩家储存数据，使用了SQL（详见配置文件)
废话: 我死了好久都没发新作品，教程也好久没更新了（决定去当好孩纸好好学习）在此表示歉意


插件由来:看到很多服务器（特别是小型服务器）缺少玩家所以开启了推荐玩家奖励政策不过却没有办法自动化，结果就是导致无法及时发送奖励或者管理员非常累。于是我决定捞一波金粒&人气写这个插件

正确食用方法：下载并扔到服务器plugins文件夹里，之后重启如果是windows服务器请使用ANSI编码，linux用UTF-8默认UTF-8（不知道为什么我家win电脑就是得用utf8）

插件截图:P.S. 本插件V1.0已更新部分提示，截图为旧版本

/refs help 显示的帮助界面

我们先使用/refs create 创建一个推荐码

看到了这个神奇的东西，现在我们再吧这个码发给别人。。

小号登陆使用推荐码，这里我们的设置是玩家等级必须要高于10才可以，所以新账号当然不能用啦

于是乎我们吧等级加到足够之后再试试看....可以了！

插件配置文件(建议查看):
config.yml(带介绍的配置文件)

#密钥设置 key: length: 8    #密钥长度 recreate: true    #可以重复创建key: #数据库设置 db: mysql: false #是否使用mysql（目前只有mysql/sqlite) url: 'localhost' #mysql 地址 port: 3386 #mysql端口 database: 'mysql' #mysql数据库 username: 'root' #mysql用户名 password: 'root' #mysql密码 cond:    #条件设置 enabled: true    #是否开启 description: "&a等级达到&elv10"    #给予玩家的介绍（当玩家未达到要求时） type: "exp"    #种类，可以是exp(经验值)或者item(物品，支持rpg物品哦) explevel: 10    #如果是经验值的话，玩家等级至少需要 item:     id: 362    #物品id     amount: 4    #物品数量     data: 0    #物品附属id(比如说物品id是25:12, 那么附属id就是12，id就是25）     name: "&b&lDIAMOND"    #物品名字（如果不需要可以整行删掉，切勿留空）     lore:    #物品标签（如果不需要可以整行删掉，切勿留空）    - "&bthis diamond allows you to do sth" rewards:  #奖励系统任何条目均可使用%target代表被推荐人的id，%ref代表推荐人的id successCommands:    #成功时运行的指令，通过后台发送     - "give %target diamond 100"     - "eco give %ref 400" successMessages:    #成功时的消息     target:    #发送给被推荐人    - "恭喜你, 给你了100个钻石"     ref:    #发送给推荐人    - "你邀请了 %target， 给你了400大洋"     server:    #全服广播    - "%ref邀请了 %target, 大家欢迎%target"

默认lang.yml(语言文件): 我太懒了语言文件你们自己看吧。。。应该不会太难懂, %target代表被推荐人的id, %key代表密钥 %cond代表条件介绍

prefix: "&e[&7Referrals&e]" load: success: "&a&l!!!成功加载 Referrals!!!" noperm: "&c你可能有的是假权限, 你需要: &a%perm" reload: success: "&a成功重载!" show: header: "&a=====&6玩家%target&b的信息&a======" master: "&a当前跟随: &6%player" nomaster: "&a当前跟随: &c无" key: "&a推荐密钥: &6%key" nokey: "&a推荐密钥: &c无" noplayer: "&c错误: 无法找到该玩家" followers: "&a已推荐&c%count&a人: &6%list" otherusage: "&c使用方法: &e/refs show <id>" canceldefaultreason: "没理由" use: success: "&a成功跟随&e%ref" fail: "&c无法使用(无效的密钥/自己/已跟随)!" usage: "&c使用方法: &e/refs use <密钥>" keynotfound: "&c你可能输入的是假密钥" alreadyfollow: "&c你不可能被推荐两次!" noself: "&c你不可以推荐你自己啊兄弟...." conditionnotmet: "&c你没有达到要求: &e%cond" create: success: "&a你创建了一个密钥: &6%key" norecreate: "&c服务器禁止再次创建密钥, 请使用&6/refs show&c来查看你当前的密钥" confirm: "&c请输入 &e/refs create confirm &c来确定创建新的密钥, &4&l将会使原来的密钥失效!" mustbeplayer: "&c你可能是个假人" sql_error: "&c数据库错误" help:   #帮助菜单 - "&d---------&6Referrals帮助&d-----------" - "&e  本插件由berry64制作" - "&a/refs create    &b创建/更新一个密钥" - "&a/refs use    &b使用一个密钥" - "&a/refs show   &b显示推荐信息" - "&d--------------------------------"

权限:refs.create 给自己创建密钥refs.use 自己使用密钥refs.show 看自己的信息refs.user 玩家通用的权限，包含(create,show,use)refs.show.other 查看其他人的信息refs.reload 重载插件


指令：自行/refs help 查看


看到这你大概觉得玩家推荐奖励系统太简单了对不对。所以，本插件带有简易api帮助各位插件开发者来做出更符合自己的推荐系统！使用本api的插件：无如果希望上榜请回复插件名字，介绍，版本，链接，【可选】图片


api教程: （非程序员慎入你可能会晕）插件自带一个event，使用方法很简单，和其他任何event一样。导入本插件到前置库并且监听ReferralSuccessEvent 下面是一个用论坛写的简易栗子如果有错误。。。那就不要在意:

代码:

1. @EventHandler
   
2. public void onRef(ReferralSuccessEvent evt){
   
3.     Bukkit.broadcastMessage(evt.getPlayer());
   
4. }

你可以反编译本插件，然后试着学习【手动斜眼】，加油！但是你不可以未经过我的同意就擅自把本插件发到其他任何网站，如有需要请在本帖回复


TODO/未来计划：- 增强api，并允许获取推荐者的推荐总数。栗子：可以在推荐者推荐5位时给出附加奖励- 没了。。。如果有需要请回复本帖。

没人要看的更新日志:0.0.1-ALPHA    第一次放出插件0.0.2-ALPHA    @g98107092提出的bug修复0.0.3-ALPHA(其实是0.0.2因为懒得改了)  @NGK3提出的bug修复
2019/2/2 - V1.0 正式版SQL 更新!

至于为什么我到现在还没有放上下载地址。。是因为。。。伸手党太多了。
好不容易写出来的插件得不到回报，请至少给点人气（不会消耗任何自己的东西）并回复一下（免费获取金币）如果太懒可以直接复制以下文字回复

代码:

1. 作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~

谢谢支持! 请先回复/评论写了好久的呢╭(╯^╰)╮ P.S欢迎帮忙翻译/修改语言文件
牢骚: 哎哎哎为什么无法隐藏图片

berry64 - - ！！！

本帖最后由 LocyDragon 于 2017-2-3 17:37 编辑

berry64诶~顶一发
顺便问一下这个事件是在什么情况下触发的?

当玩家成功地使用了密钥之后触发

如果玩家自己创小号呢- -

所以才有条件

-.-什么条件- -

不看配置文件?

可以无限领取自己生成的密钥

感谢提供bug，正在修复

很棒的插件，正好需要~作者加油~

正在等新版，希望尽快修复

成功修复，已更新

成功修复，已更新,感谢支持

一直在找类似的插件， 但是有的是连接挂了 有的是存在BUG  试试这个 ~感谢

有用yum 使用这个指令会提示报错null  我是1.7.10 mcpc端

您好 请问能防止玩家使用小号吗

乱码大法 Windows的

直接防止小号不太容易，不过我这里有设置一个要求，就是玩家只能达到要求之后才可以被推荐，这就大大减少了开新号刷的可能性

转码大法，转ANSI

是蛮好的 可以增加人气

最简单  兼容最强的就是  推荐得到一个货币，然后用这个货币换取指令

还是可以自己推荐自己 自己领取东西。。。亏我弄了半天- -

谢谢楼主带来的这个插件,以后就能全自动了

作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~

作者你好，我希望能荣幸地获得这个插件的源码！用于二次开发。因为对于小游戏服务器，多大厅必须要有MySQL的支持，我希望能让它支持MySQL，其次，对于条件格式，我希望能增加一种判断玩家在线游戏时长的形式，这需要用到我们的一个API，我相信，插件写出来将是一个很棒的作品，我们也会将作品奉上，希望作者发出，服务更多的服务器！综上，希望能获得你的允许！谢谢

作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~

不会转码qwq

可以可以正愁

谢谢楼主,2333

高举手 广积粮

作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~

不知道为啥无法评分..就回复一下好了...

建议功能：show没有的时候自动创建然后提示。这样就少了一个指令。

好棒的作品！正发愁服务器怎么宣传，赞！

确定修复好了？ 。。。 还是可以无限领取啊。。

MCBBS有你更精彩~

楼主你好，我准备在这个月中旬开坑。开坑前问一句所得源码是否修复 BUG  自己推荐自己

我的是1.8.8版本的还是可以无限领取。

作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~

LZ这个帖子若是有关键词<邀请>俩字， 目测会更火

好用，手下了，谢谢

wwwwwwwwwwwwwwwwwwwwww

作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~

作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~
作为一个java初学者，我迫切找个原创插件借鉴一下插件的写法

作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~

带走带走，就差这个了

作者辛苦了，为了鼓励作者发出更好的作品，我回复一下~~~

QWQ太好了QAQqaqQAQ