Bukkit

This is a brief description/documentation of the funtionality (0.2.5).

THIS IS NOT COMPLETE, MORE CONTENT TO BE ADDED MORE OR LESS SOON.

References: Configuration | Commands | Permissions

The plugin will name itself DTService, which is a mere obfuscation of its purpose. In the data folder (plugins/DtService) it will generate a configuration file darktrace.yml and a data file darktrace.dat automatically, since 0.2.5 default entries will be added automatically, as well as deprecated entries might get adapted as well. If in doubt delete the configuration file and use the command "/dt reload" to generate the current configuration file.

The data file should not be changed, unless you know what you are doing. It is somewhat human readable and editable though, so it is possible to change numbers, or add/delete lines.

Configuration:

• Almost everything is configurable
• Adding minimum frequency thresholds: To remove entries from suspicious checks, if a player has not mined enough blocks, add the item name or the item id like '1' for stone as key and the desired number as value to the section of suspicious.min-freq (there should be a default entry initially, which will be used if no other is given...), if you use a number really use the '<number>' notation, not just <number> .

In-game commands (same as console by now): command: /dt or /darktrace if /dt is used by other plugins. If allow-ops is set to true in the configuration (default), ops can use all commands, for other players (or if allow-ops is set to false) the lists in the permissions entry in the configuration will be checked for the player name - and/or if configured to be used: superperms.

darktrace.all allows all commands to be used, darktrace.mod allows non-modifying commands like browsing and displaying + digest.

There are command shortcuts:

• suspicious: /su su
• stats: /st st /dts dts
• display: /d /dtd
• +: /+ +
• -: /- -

Checking stats ingame features colors (!): suspicious entries are marked red.

A quick undocumented overview for commands: '/dt help'

GUIDE

• To be sure stats include the last minutes, use the "/dt digest" command before using "/dt suspicious" or "/dt stats <player>". This will ensure that also the last couple of minutes are added to the stats. [Not sure if due to a bug it is updated more often than intended.]
• Alternatively you can call /dt cleanup and then /dt su or start browsing directly.

The default configuration file (Darktrace 0.2.5):

 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

stats:
  break:
    blocks:
    - 56
    - 14
    - 15
    - 16
    - 73
    - 86
    - 48
    - 52
    - 17
    - 1
    - 2
    - 3
    - 12
    - 24
    - 13
    - 110
suspicious:
  break:
    ratio:
      stone:
        gold: 6.0
        diamond: 16.0
        iron: 2.0
    min-freq:
      '2': 50
      '24': 50
      '13': 50
      '87': 50
      '88': 50
      '12': 50
      '16': 50
      '1': 100
      '3': 100
      default: 10
    lightlevel:
      default: 2.1
configversion: 2
active: true
ignore-worlds: []
permissions:
  allow-ops: true
  players:
    all: []
    mod: []
    save: []
    reload: []
    remove: []
    disable: []
    enable: []
    erase: []
    suspicious: []
    stats: []
    digest: []
    help: []
    info: []
    item: []
    browse: []
    display: []
    cleanup: []
  superperms: true
write:
  data:
    interval: 5
    log-removed: true
display:
  max-entries: 10
  allow-prefixes: true
  show-browse-ids: true
  hide-exp: true
  blockname:
    info: true
    stats: true
    suspicious: true