Blame

e23584 Dan Alexander 2026-09-14 10:46:55
Add company wiki standards and VoxelCore docs This change establishes the shared company knowledge structure, governance, engineering, security, and incident/change standards. It also adds the VoxelHorizons product tree with a complete VoxelCore documentation set covering architecture, operations, authoring, version support, resource pack compilation, runtime reloads, and testing/release workflows.
1
# Commands and Permissions
2
3
4
> **Documentation baseline:** VoxelCore `main` at `452b569` · 14 September 2026.
5
> **Repository:** [https://github.com/VoxelHorizons/VoxelCore](https://github.com/VoxelHorizons/VoxelCore)
6
7
8
The base Bukkit command is:
9
10
```text
11
/voxelcore
12
```
13
14
with alias:
15
16
```text
17
/vc
18
```
19
20
The base command requires `voxelcore.use`. All currently declared permissions default to server operators. `admin` also has the alias `a`.
21
22
## Administrative reload
23
24
```text
25
/voxelcore admin reload
26
/voxelcore admin rl
27
```
28
29
This calls the same atomic content reload path and requires `voxelcore.admin.reload`.
30
31
## Content
32
33
```text
34
/voxelcore admin content info
35
/voxelcore admin content reload
36
/voxelcore admin content rl
37
```
38
39
Permissions:
40
41
- `voxelcore.admin.content`
42
- `voxelcore.admin.content.info`
43
- `voxelcore.admin.content.reload`
44
45
## Items
46
47
```text
48
/voxelcore admin item list
49
/voxelcore admin item info <content-id>
50
/voxelcore admin item give <content-id> [amount] [player]
51
/voxelcore admin item identify
52
/voxelcore admin item id
53
/voxelcore admin item verify <content-id>
54
/voxelcore admin item test <content-id>
55
```
56
57
`items` is an alias of the `item` command group. `id` aliases `identify`; `test` aliases `verify`.
58
59
Permissions:
60
61
- `voxelcore.admin.item`
62
- `voxelcore.admin.item.list`
63
- `voxelcore.admin.item.info`
64
- `voxelcore.admin.item.give`
65
- `voxelcore.admin.item.identify`
66
- `voxelcore.admin.item.verify`
67
68
Important current behaviour: `item list` filters the compiled registry to definitions whose `bound` value is `true`, then sorts their ContentIDs deterministically. `item info` can still inspect a known unbound definition by ID.
69
70
`give` restricts amount to 1–64. Console callers must supply a valid player; player callers default the target to themselves.
71
72
`identify` is player-only because it inspects the main-hand item. `verify` is console-safe and performs a create → persisted identity round trip.
73
74
## Resource packs
75
76
```text
77
/voxelcore admin pack info
78
/voxelcore admin pack validate [target]
79
/voxelcore admin pack build [target]
80
```
81
82
Permissions:
83
84
- `voxelcore.admin.pack`
85
- `voxelcore.admin.pack.info`
86
- `voxelcore.admin.pack.validate`
87
- `voxelcore.admin.pack.build`
88
89
Known targets are listed in [[Products/Voxel-Horizons/VoxelCore/Resource-Pack-Compiler]].
90
91
## Administrative root
92
93
`voxelcore.admin` protects the `admin`/`a` command group. Child commands then require their more specific permissions described above.