TShock插件：PlayerManager V1.3
這次加上了備份和恢復(fù)功能，應(yīng)該配得上“玩家管理”這個(gè)名字了。除此之外還支持修改永久增強(qiáng)類(lèi)屬性和釣魚(yú)任務(wù)次數(shù)。為了配合幾個(gè)腐竹大佬的“機(jī)器人”需求，還新增了兩個(gè)RESTAPI接口。文章的前半部分是介紹備份和恢復(fù)，后半部分再介紹其它的。
文件結(jié)構(gòu)
先看3張圖：
tshock\PlayerManager\?，插件的工作目錄，相關(guān)的文件都會(huì)保存在這里。
tshock\PlayerManager\backups\?，自動(dòng)備份的“.sqlite”文件會(huì)保存在這里，見(jiàn)圖2。
tshock\PlayerManager\[年月日-時(shí)分-秒]\?，執(zhí)行“/pm ea”指令后，會(huì)將全部玩家導(dǎo)出成“.plr”格式的存檔，并放進(jìn)以日期命名的文件夾里面，見(jiàn)圖3。
圖1紅色部分為plr文件，這次做了個(gè)改動(dòng)，導(dǎo)出單個(gè)玩家的plr存檔時(shí)，不會(huì)額外創(chuàng)建目錄，而是直接導(dǎo)出在插件的工作目錄下，如遇到重名情況，則會(huì)先對(duì)舊文件進(jìn)行重命名，在圖1上能找到“hf.plr” 和 “hf_20221202-0105-30.plr”這兩個(gè)文件，前者是新導(dǎo)出的，后者是之前導(dǎo)出的。
圖1綠色部分為手動(dòng)備份的文件，“.sqlite”格式的文件是數(shù)據(jù)庫(kù)文件，強(qiáng)制開(kāi)荒的所有人物數(shù)據(jù)就保存在里面。
圖1藍(lán)色部分為自動(dòng)備份相關(guān)，為了保存自動(dòng)備份狀態(tài)，這次引入了配置文件，配置文件內(nèi)容如下：
Interval，備份間隔，填0表示關(guān)閉自動(dòng)備份，填1表示每隔1（分鐘）備份一次。
KeepFor，保留時(shí)長(zhǎng)，默認(rèn)值是240（分鐘），即4個(gè)小時(shí)，填0表示不刪除自動(dòng)備份的文件。
ShowSaveMessages，備份提示，填false表示不顯示，填true則會(huì)在命令行界面上顯示“[pm]SSC已備份”字樣。
指令匯總
/pm help 3，查看pm指令幫助的第3頁(yè)。不需要去背指令，很多指令都提供了“幫助”選項(xiàng)，對(duì)指令有疑問(wèn)，只要在指令后面加上“ help”，執(zhí)行“/pm backup help”、“/pm recover help” 和 “/pm list help”可以查詢(xún) 備份/恢復(fù)/列表 這3個(gè)指令的用法。
/pm b [備注]，b是backup的簡(jiǎn)寫(xiě)，直接執(zhí)行“/pm b”而不加備注時(shí)，會(huì)自動(dòng)使用當(dāng)前的日期進(jìn)行備注，每次手動(dòng)備份，備份點(diǎn)的序號(hào)都會(huì)加1，備份點(diǎn)就是數(shù)字，大于0的數(shù)字。
/pm r <玩家名>?<備份點(diǎn)>，r是recover的簡(jiǎn)寫(xiě)，例如要將玩家hf恢復(fù)至第1個(gè)備份點(diǎn)，則是執(zhí)行“/pm r hf 1”，第2個(gè)備份點(diǎn)，則是“/pm r hf 2”。
/pm list backup，列出可用的備份點(diǎn)。這里會(huì)對(duì)備份點(diǎn)進(jìn)行排序，最近的排在前面。
/pm?list?<備份點(diǎn)>，列出備份點(diǎn)里的玩家列表。這里你會(huì)發(fā)現(xiàn) /pm list?指令有兩種用法，一個(gè)是列出文件，一個(gè)是列出文件里的玩家，也就是查看 文件列表和玩家列表。
/pm?b status，查看自動(dòng)備份的狀態(tài)。
/pm?b <on/off>，開(kāi)啟/關(guān)閉 自動(dòng)備份，默認(rèn)開(kāi)啟時(shí)會(huì)將備份頻率改成2分鐘一次。如果自動(dòng)備份是開(kāi)啟狀態(tài)，執(zhí)行“/pm b on”，則會(huì)提示已開(kāi)啟過(guò)了，關(guān)閉指令也是如此。
/pm b interval <分鐘數(shù)>, 設(shè)置自動(dòng)備份間隔，設(shè)置成0時(shí)會(huì)關(guān)閉自動(dòng)備份。
/pm b keepfor <分鐘數(shù)>, 設(shè)置備份文件的期限。
/pm reload,?重載配置文件。目前配置項(xiàng)只有3個(gè)，其中2個(gè)是通過(guò)上面的幾個(gè)指令來(lái)調(diào)節(jié)和查看。
/pm?list ab,?列出自動(dòng)備份的文件。其中ab是autobackup的縮寫(xiě)，新備份的文件會(huì)靠前顯示。
/pm?list <日期.sqlite>,?列出“.sqlite”文件里的玩家列表。
/pm?r <玩家名> <日期.sqlite>,?將玩家恢復(fù)至自動(dòng)備份的數(shù)據(jù)文件。
/pm b?keep?<日期.sqlite>,?保留一個(gè)自動(dòng)備份文件。自動(dòng)備份的文件會(huì)在一定時(shí)間后被刪除，可以通過(guò)這個(gè)指令將某個(gè)備份轉(zhuǎn)成備份點(diǎn)，這樣文件就不會(huì)因?yàn)檫^(guò)期而被刪除。而且下次還可以通過(guò) “/pm r <玩家名> <備份點(diǎn)序號(hào)>”恢復(fù)玩家。
/pm list?plr,?列出plr文件，將列出工作目錄下的plr文件，這些plr文件可以做恢復(fù)玩家存檔用，注意為了避免沖突，“tshock\PlayerManager\[年月日-時(shí)分-秒]\”目錄下的plr文件不會(huì)被列出。
/pm r?<玩家名>?<xx.plr>,?恢復(fù)至plr文件。從數(shù)據(jù)庫(kù)（.sqlite）里恢復(fù)時(shí)，玩家名必須匹配，就是你沒(méi)法把張三恢復(fù)成李四，此時(shí)你可以把李四導(dǎo)出成plr，“/pm export 李四”，然后輸入 “/pm r 張三 李四.plr”，此時(shí)除了名字不同外，張三和李四的外觀、背包和屬性都是一樣的。除了整“真假美猴王”這種爛活外，也是可以導(dǎo)入一些好看的“捏人”以及大佬的裝備搭配。
當(dāng)玩家在線時(shí)，還會(huì)導(dǎo)入plr里面的buff。由于SSC（強(qiáng)制開(kāi)荒）未保存buff數(shù)據(jù)，因此離線玩家無(wú)法導(dǎo)入buff。
/pm r <玩家名> <目標(biāo)> [僅背包/僅皮膚/僅buff/僅屬性],??按選項(xiàng)進(jìn)行恢復(fù)。無(wú)論是備份點(diǎn)、自動(dòng)備份 還是 .plr文件，都支持按選項(xiàng)進(jìn)行恢復(fù)，目前額外提供了4個(gè)單獨(dú)選項(xiàng)，這三個(gè)選項(xiàng)除輸入漢字外，還可以用1/2/3/4代替。
至此，插件的一點(diǎn)邏輯就顯現(xiàn)，在 備份、恢復(fù)和列表這幾個(gè)指令里面有這樣的潛規(guī)則：
?1,2,3 是指?jìng)浞蔹c(diǎn)，文件是保存在pm插件的工作目錄下，文件名的格式為“序號(hào)_備注.sqlite”或“序號(hào)_日期.sqlite”。
日期.sqlite 是指自動(dòng)備份的文件，是保存在pm插件工作目錄下的backups目錄下。
xx.plr 是指可用于恢復(fù)的plr文件，是保存在pm插件的工作目錄下，“tshock\PlayerManager\[年月日-時(shí)分-秒]\”目錄下的plr沒(méi)法用于恢復(fù)。
當(dāng)然這幾個(gè)指令還有這幾條“潛規(guī)則”：
/pm list?0, 列出當(dāng)前服務(wù)器的玩家列表。這里顯示的id就是數(shù)據(jù)庫(kù)里面“Users”表里面的“id”字段。列出玩家列表時(shí)，會(huì)額外顯示玩家的生命和魔力，能一定程度上啟動(dòng)識(shí)別備份情況的作用。
/pm r <玩家名>?0,?將某個(gè)玩家恢復(fù)至初始狀態(tài)。想重置某個(gè)玩家，就執(zhí)行這個(gè)指令。如果只是想恢復(fù)到進(jìn)服時(shí)的外觀，就執(zhí)行“/pm r <玩家名> 0 僅皮膚”。
我是分割線啊，你應(yīng)該看得到
我是分割線啊，你一定看得到
開(kāi)關(guān) 永久增強(qiáng)屬性
/pm enhance <玩家名>?<物品名稱(chēng)>，開(kāi)啟/關(guān)閉 永久增強(qiáng)屬性，例如那個(gè)叫hf的屑，總過(guò)不了火把神，又想要生態(tài)火把效果，則可以執(zhí)行 “/pm en hf 火把神徽章”，火把神徽章也可以用5043這個(gè)數(shù)字代替。這個(gè)指令，第一次執(zhí)行是開(kāi)啟，如果已經(jīng)是開(kāi)啟狀態(tài)，再次執(zhí)行就是關(guān)閉。
泰拉1.4.4就增加了8種永久增強(qiáng)屬性，還不知道又有啥，怎么獲得，趕緊去wiki上查一查吧。另外世界也有“永久增強(qiáng)”屬性，1.4.4還增加了兩種，由于是世界屬性，本插件就不處理了~
修改釣魚(yú)任務(wù)次數(shù)
/pm quest <玩家名>?<次數(shù)>，修改某個(gè)玩家的釣魚(yú)次數(shù)，算是和魚(yú)店插件聯(lián)動(dòng)了~~/doge
REST API
如果還你不知道REST API是什么，請(qǐng)去移步閱讀/實(shí)踐下這篇文章。
有編程經(jīng)驗(yàn)的同學(xué)，應(yīng)該能很快上手，如果看不懂，就請(qǐng)忽略這個(gè)功能。
新增的 REST API?接口參見(jiàn)：https://gitee.com/hufang360/TShockPlayerManager/blob/master/RESTAPI.md
接口1：查看指定玩家，/pm/look?token={{token}}&name=hf
接口2：導(dǎo)出單個(gè)玩家，并返回文件所在目錄，/pm/export?token={{token}}&name=hf
這兩個(gè)接口主要是方便哪些使用“機(jī)器人”的服務(wù)器，能夠查詢(xún)和獲得玩家存檔，里面查詢(xún)到的結(jié)果基本都是一些數(shù)字，需要機(jī)器人請(qǐng)求到這個(gè)數(shù)據(jù)后，根據(jù)物品id進(jìn)行展示查背包結(jié)果。到使用導(dǎo)出玩家接口時(shí)，開(kāi)啟base64返回時(shí)，要額外將base64字符串轉(zhuǎn)成.plr存檔。
講得有點(diǎn)含糊，就這樣吧，有能力的腐竹自然看得懂，看不懂的也沒(méi)別要折騰這個(gè)。
關(guān)于開(kāi)源
寫(xiě)插件，主要是滿(mǎn)足自己的開(kāi)服需要，之后才是考慮有更多腐竹可能跟我一樣有這個(gè)需要，就發(fā)出來(lái)，因?yàn)榻^大多數(shù)tshock插件都是開(kāi)源的，那我也開(kāi)源一下，也希望tshock圈越來(lái)越好，越來(lái)越繁榮，退一步講回頭我退坑了，其它有編程能力也好拿去修改。
如果你使用插件的大部分代碼，請(qǐng)保留作者信息。插件是開(kāi)源的，請(qǐng)不要拿去買(mǎi)。
個(gè)人不接受插件定制需求，有意思的想法可以私信給我，我覺(jué)得有意思，并且以我的能力能寫(xiě)出來(lái)，我就回去寫(xiě)。如果你覺(jué)得插件功能不錯(cuò)，對(duì)你有幫助，也可以去愛(ài)發(fā)電給我充電。
開(kāi)源地址：https://gitee.com/hufang360/TShockPlayerManager
下載地址：https://gitee.com/hufang360/TShockPlayerManager/releases/tag/v1.3
愛(ài)發(fā)電：https://afdian.net/a/hufang360
