Minecraft anticheat guide

Anticheat Config Change Log Template

A copy-ready anticheat change log template with fields for the setting, reason, evidence, approver, rollback step, and review date for every change.

Log every change with its reason and rollback step

Keep one change log entry for every anticheat setting you change, whether the change came from a staff request, an alert review, or a plugin update. Each entry records the reason, the evidence, the approver, the exact setting, and how to undo it. A log that says only tuned reach cannot answer an appeal or help the next admin.

Required fields for each entry

Every field below is required. If a field does not apply, write not applicable and the reason. Leaving it blank looks like a missing step.

Required fields for each entry
FieldWhat to writePlaceholder example
IDDate plus a sequence number<yyyy-mm-dd>-<nn>
SettingExact file and key path, not a description<file>: <key path>
ChangeOld value and new value, copied from the config<old value> to <new value>
ReasonThe problem you saw, in one sentence<check name> alerts after <event type>
EvidencePath or link to the alert sample and its labels<sample file or channel link>
ApproverName of the person who approved the change<staff name>
Applied byWho made the change, when, and how the server reloaded<staff name>, <timestamp>, <method>
RollbackThe exact step that restores the old valueRestore <old value> in <file>, then reload
Review dateWhen to check whether the change worked<yyyy-mm-dd>
OutcomeFilled in at review time: kept, reverted, or extended<outcome and reason>

Copy the template

Paste this block into a shared document or a text file in your config repository. Replace each placeholder and remove any field you do not use. Keep Reason, Approver, and Rollback, because an appeal or an incident review needs all three.

Change log entry template (placeholders)
ID:          <yyyy-mm-dd>-<nn>
Setting:     <file>: <key path>
Change:      <old value> -> <new value>
Reason:      <one sentence describing the alert pattern or problem>
Evidence:    <sample file or channel link>, labels: real <n>, unclear <n>, false <n>
Approver:    <name>
Applied by:  <name>, <timestamp>, reload method: <method>
Rollback:    restore <old value> in <file>, then reload with the same method
Review date: <yyyy-mm-dd>
Outcome:     <kept | reverted | extended>, <reason>

Apply the working rules

The template only works if the habits around it are consistent. These rules keep entries comparable across staff members and over time.

Review open entries on schedule

Check open entries on each review date. An entry with no outcome after its review date is a process failure, not a neutral state. Give one person the job of chasing open entries each week, and close each entry with an outcome before the same check changes again.

Worked example: one entry from start to finish

A staff member proposes raising the tolerance on a movement check after a wave of boat-related false alerts. The entry is created before the change, with the ID, setting, old value, reason, evidence path, and approver filled in. After the approved change goes live, the applied-by line gets the time and reload method. The review date is set three days out. On that date, the outcome line records kept, along with the labeled counts from the new window. That single entry is what an appeal needs for the period.

Common mistakes with change logs

A log fails quietly. Entries look complete until someone needs one during an appeal, so check for these habits during each review.

What the log does not do

The log records decisions and the evidence stated for them. It does not make a decision correct, and it does not replace the alert data. If an entry cites a sample you no longer have, write that gap into the evidence field instead of leaving it blank.

FAQ

Do we need an entry for a plugin update?

Yes, when the update changes a setting, a default, or an alert type. Record the version before and after, and list the settings you checked, even if none of them changed.

Is a chat message enough evidence?

A message can support the reason, but the entry still needs the setting, the values, and the rollback step. Link the message in the evidence field.

What do we write for an emergency change?

Make the smallest change that stops the problem and write the entry during the same shift. Mark the approver field as emergency, approval pending, and set a review date for the next working day.

Should players be able to read this log?

Usually not in full, since it can name staff and contain internal reasons. If an appeal needs part of an entry, copy only the reason and date that apply.

How long do we keep closed entries?

Keep them at least as long as your appeal window and any retention rule for alert evidence. Closed entries name staff and hold internal reasons, so store them with the same access limits as the config repository.

Related sources and official pages

Browse all anticheat guides