massivecraft-logotype-plugin-massivebooks-2000

Player Guide
Server Owner Guide
Spigot
Bukkit
GitHub
Contents
  1. For Server Owners
    1. MassiveCore Aspects
    2. Multiverse Conf
    3. plugin.yml

For Server Owners

  • Put MassiveCore.jar in the plugins folder. Use the right MassiveCore version.
  • Put massivebooks.jar in the plugins folder.
  • Start the server and immediately stop it again to generate the default configs.
  • Modify /mstore/massivebooks_mconf/instance.json to your liking.
  • Configure permissions. You may want to use the “kit” parent permissions.

MassiveCore Aspects

MassiveBooks does not use MassiveCore aspects. No need to worry about those.

Multiverse Conf

The multiverse conf is the file /mstore/massivebooks_mconf/instance.json. You can make changes to this file while the server is running. The modifications will automatically be detected after a few seconds and loaded into the server. You don’t need to run any command or restart the server for this to happen.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
  "aliasesBook": [
    "book",
    "books"
  ],
  "usingNewPlayerCommands": true,
  "newPlayerCommands": [
    "/book give {p} ensure all"
  ],
  "usingNewPlayerCommandsDelayTicks": true,
  "newPlayerCommandsDelayTicks": 5,
  "permToCopyCost": {
    "massivebooks.copycost.free": 0.0,
    "massivebooks.copycost.0": 0.0,
    "massivebooks.copycost.0.01": 0.01,
    "massivebooks.copycost.0.02": 0.02,
    "massivebooks.copycost.0.03": 0.03,
    "massivebooks.copycost.0.1": 0.1,
    "massivebooks.copycost.0.2": 0.2,
    "massivebooks.copycost.0.3": 0.3,
    "massivebooks.copycost.1": 1.0,
    "massivebooks.copycost.2": 2.0,
    "massivebooks.copycost.3": 3.0,
    "massivebooks.copycost.10": 10.0,
    "massivebooks.copycost.20": 20.0,
    "massivebooks.copycost.30": 30.0,
    "massivebooks.copycost.default": 0.0
  },
  "autoupdatingServerbooks": true,
  "autoupdatingDisplayNames": true,
  "usingAuthorDisplayName": true,
  "itemFrameLoadIfSneakTrue": false,
  "itemFrameLoadIfSneakFalse": true,
  "itemFrameDisplaynameIfSneakTrue": false,
  "itemFrameDisplaynameIfSneakFalse": true,
  "itemFrameRotateIfSneakTrue": true,
  "itemFrameRotateIfSneakFalse": true
}

What the options do:

  • aliasesBook: What aliases should the base command have?
  • usingNewPlayerCommands: Should new player commands be executed or not?
  • newPlayerCommands: These commands are excecuted for players the first time they join the server. The {p} is replaced with the player name. Per default hand out all serverbooks to the new players.
  • usingNewPlayerCommandsDelayTicks: Should we wait a few server ticks before executing the the new player commands?
  • newPlayerCommandsDelayTicks: How many ticks should we wait? 20 ticks is on second.
  • permToCopyCost: If Vault is present copying books can cost money. The permissions are checked from up to down and once a match is found the cost is used. The last entry will be used if nothing matched.
  • autoupdatingServerbooks: Should books with a server book title be autoupdated to have the same content as the saved serverbook?
  • autoupdatingDisplayNames: Should books be autoupdated to have awesome and informative display names?
  • usingAuthorDisplayName: Should the author displayname be used instead of the regular name? Note that the display name can’t be known for offline players so book titles would be using the displayname only for players that are online.
  • itemFrameXIfSneakY: Handles item frame behavior.

plugin.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
main: com.massivecraft.massivebooks.MassiveBooks
name: massivebooks
version: 1.1.7
website: https://www.massivecraft.com/massivebooks
authors: [Cayorion]
description: §eMassiveBooks provides book related features such as better displaynames, copying books, unlocking locked books for more editing, powertools, unique serverbooks, and ingame libraries using item frames. §aCayorion §efrom the minecraft server §aMassiveCraft §eis the lead programmer. Feel free to visit us at §bhttps://www.massivecraft.com
depend: [mcore]
permissions:
# -------------------------------------------- #
# THE REAL NODES
# -------------------------------------------- #
  massivebooks.book: {description: access the book base-command, default: false}
  massivebooks.unlock: {description: unlock a book, default: false}
  massivebooks.unlock.other: {description: unlock a book by another author, default: false}
  massivebooks.lock: {description: lock a book, default: false}
  massivebooks.lock.other: {description: lock a book by another author, default: false}
  massivebooks.clear: {description: clear a book, default: false}
  massivebooks.clear.other: {description: clear a book by another author, default: false}
  massivebooks.title: {description: change title for a book, default: false}
  massivebooks.title.other: {description: change title for a book by another author, default: false}
  massivebooks.title.color: {description: use colors in book titles, default: false}
  massivebooks.author: {description: change author for a book, default: false}
  massivebooks.author.other: {description: change author for a book by another author, default: false}
  massivebooks.copy: {description: copy a book, default: false}
  massivebooks.copy.other: {description: copy a book by another author, default: false}
  massivebooks.copy.copyrighted: {description: copy a copyrighted book by another author, default: false}
  massivebooks.list: {description: list saved books, default: false}
  massivebooks.load: {description: load a saved book, default: false}
  massivebooks.give: {description: give saved book(s), default: false}
  massivebooks.save: {description: save a book, default: false}
  massivebooks.delete: {description: delete a saved book, default: false}
  massivebooks.autoupdate: {description: alter your autoupdate state, default: false}
  massivebooks.powertool: {description: set powertool state for a book, default: false}
  massivebooks.powertool.other: {description: set powertool state for a book by another author, default: false}
  massivebooks.copyrighted: {description: set copyrighted state for a book, default: false}
  massivebooks.copyrighted.other: {description: set copyrighted state for a book by another author, default: false}
  massivebooks.version: {description: see plugin version, default: false}
# -------------------------------------------- #
# START NOTATION
# -------------------------------------------- #
  massivebooks.*:
    default: false
    children:
      massivebooks.book: true
      massivebooks.unlock: true
      massivebooks.unlock.other: true
      massivebooks.lock: true
      massivebooks.lock.other: true
      massivebooks.clear: true
      massivebooks.clear.other: true
      massivebooks.title: true
      massivebooks.title.other: true
      massivebooks.title.color: true
      massivebooks.author: true
      massivebooks.author.other: true
      massivebooks.copy: true
      massivebooks.copy.other: true
      massivebooks.copy.copyrighted: true
      massivebooks.list: true
      massivebooks.load: true
      massivebooks.give: true
      massivebooks.save: true
      massivebooks.delete: true
      massivebooks.autoupdate: true
      massivebooks.powertool: true
      massivebooks.powertool.other: true
      massivebooks.copyrighted: true
      massivebooks.copyrighted.other: true
      massivebooks.version: true
# -------------------------------------------- #
# KITS
# -------------------------------------------- #
  massivebooks.kit.op:
    default: op
    children:
      massivebooks.*: true
  massivebooks.kit.rank3:
    default: false
    children:
      massivebooks.kit.rank2: true
  massivebooks.kit.rank2:
    default: false
    children:
      massivebooks.kit.rank1: true
  massivebooks.kit.rank1:
    default: false
    children:
      massivebooks.kit.rank0: true
      massivebooks.unlock.other: true
      massivebooks.lock.other: true
      massivebooks.title.other: true
      massivebooks.title.color: true
      massivebooks.author: true
      massivebooks.author.other: true
      massivebooks.copy.copyrighted: true
      massivebooks.give: true
      massivebooks.save: true
      massivebooks.delete: true
      massivebooks.autoupdate: true
      massivebooks.powertool: true
      massivebooks.powertool.other: true
      massivebooks.copyrighted.other: true
  massivebooks.kit.rank0:
    default: false
    children:
      massivebooks.book: true
      massivebooks.unlock: true
      massivebooks.lock: true
      massivebooks.clear: true
      massivebooks.clear.other: true
      massivebooks.title: true
      massivebooks.copy: true
      massivebooks.copy.other: true
      massivebooks.list: true
      massivebooks.load: true
      massivebooks.copyrighted: true
      massivebooks.version: true
  massivebooks.kit.default:
    default: true
    children:
      massivebooks.kit.rank0: true