feat: essentials integration APIs and complete event coverage - #107

Merged
derrickmehaffy merged 2 commits into
releases/0.12.0from
feat/essentials-integration
Mar 16, 2026
Merged

feat: essentials integration APIs and complete event coverage#107
derrickmehaffy merged 2 commits into
releases/0.12.0from
feat/essentials-integration

Conversation

@derrickmehaffy

@derrickmehaffyderrickmehaffy commented Mar 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds HyperEssentials integration APIs — faction home convenience methods, zone flag checking, ESSENTIALS_BACK zone flag, FactionHomeTeleportEvent
  • Completes event system with full coverage across all systems (16 new events wired into 12 managers)
  • Updates API documentation with complete event reference

Essentials Integration

  • hasFactionHome(), getFactionHomeWorld(), getFactionHomeCoords(), getFactionHomeCooldownRemaining() — stable API replacing reflection
  • isZoneFlagAllowed() for homes/warps/kits/back restrictions
  • FactionHomeTeleportEvent for both instant and warmup teleports

New Post-Events (10)

  • CombatTagEvent, CombatLogoutEvent, PlayerTerritoryChangeEvent, PlayerPowerChangeEvent
  • FactionChatEvent, FactionTransactionEvent, TeleportCancelledEvent
  • FactionInviteEvent, FactionJoinRequestEvent, ZoneCreateEvent, ZoneRemoveEvent

New Cancellable Pre-Events (6)

  • CombatTagPreEvent, FactionChatPreEvent, FactionTransactionPreEvent
  • FactionHomeTeleportPreEvent, FactionUnclaimPreEvent

Test plan

  • ./gradlew :HyperFactions:shadowJar builds successfully
  • ./gradlew :HyperFactions:test — 211 tests pass, 0 failures
  • Deploy and verify territory change events fire on movement
  • Verify combat tag events fire on PvP
  • Verify faction chat pre-event cancellation
  • Verify HyperEssentials back tracking via FactionHomeTeleportEvent
  • Verify zone flag restrictions for homes/warps/kits/back

@derrickmehaffy
feat: essentials integration — API convenience methods, zone flag, an…
d107c67
…d teleport event
Add HyperFactionsAPI convenience methods for faction home queries and zone
flag checks so HyperEssentials can use stable API methods instead of direct
Faction class reflection:
- hasFactionHome(UUID), getFactionHomeWorld(UUID), getFactionHomeCoords(UUID)
- getFactionHomeCooldownRemaining(UUID)
- isZoneFlagAllowed(String, double, double, String)
Add ESSENTIALS_BACK zone flag alongside existing ESSENTIALS_HOMES/WARPS/KITS
for controlling /back teleport in zones. Defaults to allowed in both safe and
war zones.
Add FactionHomeTeleportEvent fired when a player teleports to faction home
(both instant and warmup-completed), enabling HyperEssentials to subscribe
via EventBus for back location tracking without coupling.
@derrickmehaffy
feat(events): complete event coverage — 16 new events across all systems
1454c11
New post-events:
- CombatTagEvent (TAGGED/EXPIRED/CLEARED), CombatLogoutEvent
- PlayerTerritoryChangeEvent (territory entry/exit)
- PlayerPowerChangeEvent (DEATH/KILL/NEUTRAL_KILL/REGEN/COMBAT_LOGOUT/ADMIN)
- FactionChatEvent (FACTION/ALLY channels)
- FactionTransactionEvent (treasury operations)
- TeleportCancelledEvent (MOVED/DAMAGE/COMBAT_TAGGED/MANUAL)
- FactionInviteEvent, FactionJoinRequestEvent (CREATED/ACCEPTED/DECLINED/EXPIRED)
- ZoneCreateEvent, ZoneRemoveEvent
New cancellable pre-events:
- CombatTagPreEvent — prevent combat tagging
- FactionChatPreEvent — filter/block faction chat messages
- FactionTransactionPreEvent — block treasury transactions
- FactionHomeTeleportPreEvent — cancel /f home teleports
- FactionUnclaimPreEvent — prevent manual unclaims
Wired into: CombatTagManager, PowerManager, ChatManager, EconomyManager,
ClaimManager, TeleportManager, InviteManager, JoinRequestManager,
ZoneManager, TerritoryNotifier, TerritoryTickingSystem, HomeSubCommand
Updated API docs with complete event reference organized by system.
@derrickmehaffyderrickmehaffy added the enhancement New feature or request label Mar 16, 2026
@derrickmehaffy
derrickmehaffy merged commit 3328a81 into releases/0.12.0Mar 16, 2026
@derrickmehaffy
derrickmehaffy deleted the feat/essentials-integration branch March 16, 2026 04:19
derrickmehaffy added a commit that referenced this pull request Mar 16, 2026
@derrickmehaffy
docs: update documentation and changelog for 0.12.0 release
37b1bc0
Audit all docs against actual codebase and fix stale counts, missing
sections, and outdated references across 11 files.
CHANGELOG: add missing #106 (API expansion) and #107 (essentials
integration) entries. Architecture: update to 480 classes, 16 managers,
~46 subcommands, ~76 GUI pages, add missing packages (messages/,
economy/, importers). Config: migration chain v1→v8, add V7→V8 docs.
Protection zones: 57 flags with new pve_damage, interaction flags
(mount_use, light_use, npc/crate flags), transport mount_entry, and
essentials integration flags. Commands: remove nonexistent
AdminSentryHandler. Managers: add ChatHistoryManager to index and init
order. Storage: version and importer updates. API: JitPack v0.12.0.
README: remove Sentry rows, add BetterMap/HyperEssentials integrations,
update all counts. CurseForge: reduce per-bullet emoji density while
keeping section headers and semantic indicators.
@derrickmehaffyderrickmehaffy mentioned this pull request Mar 18, 2026
Merged
86 tasks
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

enhancementNew feature or request

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@derrickmehaffy
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
feat: essentials integration APIs and complete event coverage - #107
Merged
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Mar 16, 2026
Merged
feat: essentials integration APIs and complete event coverage#107
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Conversation
@derrickmehaffy
@derrickmehaffyderrickmehaffy
commented
Mar 16, 2026

Copy link


Copy Markdown

Contributor
Summary
  • Adds HyperEssentials integration APIs — faction home convenience methods, zone flag checking, ESSENTIALS_BACK zone flag, FactionHomeTeleportEvent
  • Completes event system with full coverage across all systems (16 new events wired into 12 managers)
  • Updates API documentation with complete event reference
Essentials Integration
  • hasFactionHome(), getFactionHomeWorld(), getFactionHomeCoords(), getFactionHomeCooldownRemaining() — stable API replacing reflection
  • isZoneFlagAllowed() for homes/warps/kits/back restrictions
  • FactionHomeTeleportEvent for both instant and warmup teleports
New Post-Events (10)
  • CombatTagEvent, CombatLogoutEvent, PlayerTerritoryChangeEvent, PlayerPowerChangeEvent
  • FactionChatEvent, FactionTransactionEvent, TeleportCancelledEvent
  • FactionInviteEvent, FactionJoinRequestEvent, ZoneCreateEvent, ZoneRemoveEvent
New Cancellable Pre-Events (6)
  • CombatTagPreEvent, FactionChatPreEvent, FactionTransactionPreEvent
  • FactionHomeTeleportPreEvent, FactionUnclaimPreEvent
Test plan
  • ./gradlew :HyperFactions:shadowJar builds successfully
  • ./gradlew :HyperFactions:test — 211 tests pass, 0 failures
  •  Deploy and verify territory change events fire on movement
  •  Verify combat tag events fire on PvP
  •  Verify faction chat pre-event cancellation
  •  Verify HyperEssentials back tracking via FactionHomeTeleportEvent
  •  Verify zone flag restrictions for homes/warps/kits/back
@derrickmehaffy
feat: essentials integration — API convenience methods, zone flag, an…
d107c67
…d teleport event
Add HyperFactionsAPI convenience methods for faction home queries and zone
flag checks so HyperEssentials can use stable API methods instead of direct
Faction class reflection:
- hasFactionHome(UUID), getFactionHomeWorld(UUID), getFactionHomeCoords(UUID)
- getFactionHomeCooldownRemaining(UUID)
- isZoneFlagAllowed(String, double, double, String)
Add ESSENTIALS_BACK zone flag alongside existing ESSENTIALS_HOMES/WARPS/KITS
for controlling /back teleport in zones. Defaults to allowed in both safe and
war zones.
Add FactionHomeTeleportEvent fired when a player teleports to faction home
(both instant and warmup-completed), enabling HyperEssentials to subscribe
via EventBus for back location tracking without coupling.
@derrickmehaffy
feat(events): complete event coverage — 16 new events across all systems
1454c11
New post-events:
- CombatTagEvent (TAGGED/EXPIRED/CLEARED), CombatLogoutEvent
- PlayerTerritoryChangeEvent (territory entry/exit)
- PlayerPowerChangeEvent (DEATH/KILL/NEUTRAL_KILL/REGEN/COMBAT_LOGOUT/ADMIN)
- FactionChatEvent (FACTION/ALLY channels)
- FactionTransactionEvent (treasury operations)
- TeleportCancelledEvent (MOVED/DAMAGE/COMBAT_TAGGED/MANUAL)
- FactionInviteEvent, FactionJoinRequestEvent (CREATED/ACCEPTED/DECLINED/EXPIRED)
- ZoneCreateEvent, ZoneRemoveEvent
New cancellable pre-events:
- CombatTagPreEvent — prevent combat tagging
- FactionChatPreEvent — filter/block faction chat messages
- FactionTransactionPreEvent — block treasury transactions
- FactionHomeTeleportPreEvent — cancel /f home teleports
- FactionUnclaimPreEvent — prevent manual unclaims
Wired into: CombatTagManager, PowerManager, ChatManager, EconomyManager,
ClaimManager, TeleportManager, InviteManager, JoinRequestManager,
ZoneManager, TerritoryNotifier, TerritoryTickingSystem, HomeSubCommand
Updated API docs with complete event reference organized by system.
@derrickmehaffyderrickmehaffy
added
the 
enhancement
New feature or request
label
Mar 16, 2026
@derrickmehaffy
derrickmehaffy
merged commit 3328a81
into
releases/0.12.0Mar 16, 2026
@derrickmehaffy
derrickmehaffy
deleted the

feat/essentials-integration

branch
March 16, 2026 04:19
derrickmehaffy added a commit
that referenced
this pull request
Mar 16, 2026
@derrickmehaffy
docs: update documentation and changelog for 0.12.0 release
37b1bc0
Audit all docs against actual codebase and fix stale counts, missing
sections, and outdated references across 11 files.
CHANGELOG: add missing #106 (API expansion) and #107 (essentials
integration) entries. Architecture: update to 480 classes, 16 managers,
~46 subcommands, ~76 GUI pages, add missing packages (messages/,
economy/, importers). Config: migration chain v1→v8, add V7→V8 docs.
Protection zones: 57 flags with new pve_damage, interaction flags
(mount_use, light_use, npc/crate flags), transport mount_entry, and
essentials integration flags. Commands: remove nonexistent
AdminSentryHandler. Managers: add ChatHistoryManager to index and init
order. Storage: version and importer updates. API: JitPack v0.12.0.
README: remove Sentry rows, add BetterMap/HyperEssentials integrations,
update all counts. CurseForge: reduce per-bullet emoji density while
keeping section headers and semantic indicators.
@derrickmehaffyderrickmehaffy
mentioned this pull request
Mar 18, 2026
 Merged

86 tasks
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels

enhancementNew feature or request

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@derrickmehaffy

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: essentials integration APIs and complete event coverage - #107
Merged
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Mar 16, 2026
Merged
feat: essentials integration APIs and complete event coverage#107
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Conversation
@derrickmehaffy
@derrickmehaffyderrickmehaffy
commented
Mar 16, 2026

Copy link


Copy Markdown

Contributor
Summary
  • Adds HyperEssentials integration APIs — faction home convenience methods, zone flag checking, ESSENTIALS_BACK zone flag, FactionHomeTeleportEvent
  • Completes event system with full coverage across all systems (16 new events wired into 12 managers)
  • Updates API documentation with complete event reference
Essentials Integration
  • hasFactionHome(), getFactionHomeWorld(), getFactionHomeCoords(), getFactionHomeCooldownRemaining() — stable API replacing reflection
  • isZoneFlagAllowed() for homes/warps/kits/back restrictions
  • FactionHomeTeleportEvent for both instant and warmup teleports
New Post-Events (10)
  • CombatTagEvent, CombatLogoutEvent, PlayerTerritoryChangeEvent, PlayerPowerChangeEvent
  • FactionChatEvent, FactionTransactionEvent, TeleportCancelledEvent
  • FactionInviteEvent, FactionJoinRequestEvent, ZoneCreateEvent, ZoneRemoveEvent
New Cancellable Pre-Events (6)
  • CombatTagPreEvent, FactionChatPreEvent, FactionTransactionPreEvent
  • FactionHomeTeleportPreEvent, FactionUnclaimPreEvent
Test plan
  • ./gradlew :HyperFactions:shadowJar builds successfully
  • ./gradlew :HyperFactions:test — 211 tests pass, 0 failures
  •  Deploy and verify territory change events fire on movement
  •  Verify combat tag events fire on PvP
  •  Verify faction chat pre-event cancellation
  •  Verify HyperEssentials back tracking via FactionHomeTeleportEvent
  •  Verify zone flag restrictions for homes/warps/kits/back
@derrickmehaffy
feat: essentials integration — API convenience methods, zone flag, an…
d107c67
…d teleport event
Add HyperFactionsAPI convenience methods for faction home queries and zone
flag checks so HyperEssentials can use stable API methods instead of direct
Faction class reflection:
- hasFactionHome(UUID), getFactionHomeWorld(UUID), getFactionHomeCoords(UUID)
- getFactionHomeCooldownRemaining(UUID)
- isZoneFlagAllowed(String, double, double, String)
Add ESSENTIALS_BACK zone flag alongside existing ESSENTIALS_HOMES/WARPS/KITS
for controlling /back teleport in zones. Defaults to allowed in both safe and
war zones.
Add FactionHomeTeleportEvent fired when a player teleports to faction home
(both instant and warmup-completed), enabling HyperEssentials to subscribe
via EventBus for back location tracking without coupling.
@derrickmehaffy
feat(events): complete event coverage — 16 new events across all systems
1454c11
New post-events:
- CombatTagEvent (TAGGED/EXPIRED/CLEARED), CombatLogoutEvent
- PlayerTerritoryChangeEvent (territory entry/exit)
- PlayerPowerChangeEvent (DEATH/KILL/NEUTRAL_KILL/REGEN/COMBAT_LOGOUT/ADMIN)
- FactionChatEvent (FACTION/ALLY channels)
- FactionTransactionEvent (treasury operations)
- TeleportCancelledEvent (MOVED/DAMAGE/COMBAT_TAGGED/MANUAL)
- FactionInviteEvent, FactionJoinRequestEvent (CREATED/ACCEPTED/DECLINED/EXPIRED)
- ZoneCreateEvent, ZoneRemoveEvent
New cancellable pre-events:
- CombatTagPreEvent — prevent combat tagging
- FactionChatPreEvent — filter/block faction chat messages
- FactionTransactionPreEvent — block treasury transactions
- FactionHomeTeleportPreEvent — cancel /f home teleports
- FactionUnclaimPreEvent — prevent manual unclaims
Wired into: CombatTagManager, PowerManager, ChatManager, EconomyManager,
ClaimManager, TeleportManager, InviteManager, JoinRequestManager,
ZoneManager, TerritoryNotifier, TerritoryTickingSystem, HomeSubCommand
Updated API docs with complete event reference organized by system.
@derrickmehaffyderrickmehaffy
added
the 
enhancement
New feature or request
label
Mar 16, 2026
@derrickmehaffy
derrickmehaffy
merged commit 3328a81
into
releases/0.12.0Mar 16, 2026
@derrickmehaffy
derrickmehaffy
deleted the

feat/essentials-integration

branch
March 16, 2026 04:19
derrickmehaffy added a commit
that referenced
this pull request
Mar 16, 2026
@derrickmehaffy
docs: update documentation and changelog for 0.12.0 release
37b1bc0
Audit all docs against actual codebase and fix stale counts, missing
sections, and outdated references across 11 files.
CHANGELOG: add missing #106 (API expansion) and #107 (essentials
integration) entries. Architecture: update to 480 classes, 16 managers,
~46 subcommands, ~76 GUI pages, add missing packages (messages/,
economy/, importers). Config: migration chain v1→v8, add V7→V8 docs.
Protection zones: 57 flags with new pve_damage, interaction flags
(mount_use, light_use, npc/crate flags), transport mount_entry, and
essentials integration flags. Commands: remove nonexistent
AdminSentryHandler. Managers: add ChatHistoryManager to index and init
order. Storage: version and importer updates. API: JitPack v0.12.0.
README: remove Sentry rows, add BetterMap/HyperEssentials integrations,
update all counts. CurseForge: reduce per-bullet emoji density while
keeping section headers and semantic indicators.
@derrickmehaffyderrickmehaffy
mentioned this pull request
Mar 18, 2026
 Merged

86 tasks
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels

enhancementNew feature or request

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@derrickmehaffy

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: essentials integration APIs and complete event coverage - #107
Merged
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Mar 16, 2026
Merged
feat: essentials integration APIs and complete event coverage#107
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Conversation
@derrickmehaffy
@derrickmehaffyderrickmehaffy
commented
Mar 16, 2026

Copy link


Copy Markdown

Contributor
Summary
  • Adds HyperEssentials integration APIs — faction home convenience methods, zone flag checking, ESSENTIALS_BACK zone flag, FactionHomeTeleportEvent
  • Completes event system with full coverage across all systems (16 new events wired into 12 managers)
  • Updates API documentation with complete event reference
Essentials Integration
  • hasFactionHome(), getFactionHomeWorld(), getFactionHomeCoords(), getFactionHomeCooldownRemaining() — stable API replacing reflection
  • isZoneFlagAllowed() for homes/warps/kits/back restrictions
  • FactionHomeTeleportEvent for both instant and warmup teleports
New Post-Events (10)
  • CombatTagEvent, CombatLogoutEvent, PlayerTerritoryChangeEvent, PlayerPowerChangeEvent
  • FactionChatEvent, FactionTransactionEvent, TeleportCancelledEvent
  • FactionInviteEvent, FactionJoinRequestEvent, ZoneCreateEvent, ZoneRemoveEvent
New Cancellable Pre-Events (6)
  • CombatTagPreEvent, FactionChatPreEvent, FactionTransactionPreEvent
  • FactionHomeTeleportPreEvent, FactionUnclaimPreEvent
Test plan
  • ./gradlew :HyperFactions:shadowJar builds successfully
  • ./gradlew :HyperFactions:test — 211 tests pass, 0 failures
  •  Deploy and verify territory change events fire on movement
  •  Verify combat tag events fire on PvP
  •  Verify faction chat pre-event cancellation
  •  Verify HyperEssentials back tracking via FactionHomeTeleportEvent
  •  Verify zone flag restrictions for homes/warps/kits/back
@derrickmehaffy
feat: essentials integration — API convenience methods, zone flag, an…
d107c67
…d teleport event
Add HyperFactionsAPI convenience methods for faction home queries and zone
flag checks so HyperEssentials can use stable API methods instead of direct
Faction class reflection:
- hasFactionHome(UUID), getFactionHomeWorld(UUID), getFactionHomeCoords(UUID)
- getFactionHomeCooldownRemaining(UUID)
- isZoneFlagAllowed(String, double, double, String)
Add ESSENTIALS_BACK zone flag alongside existing ESSENTIALS_HOMES/WARPS/KITS
for controlling /back teleport in zones. Defaults to allowed in both safe and
war zones.
Add FactionHomeTeleportEvent fired when a player teleports to faction home
(both instant and warmup-completed), enabling HyperEssentials to subscribe
via EventBus for back location tracking without coupling.
@derrickmehaffy
feat(events): complete event coverage — 16 new events across all systems
1454c11
New post-events:
- CombatTagEvent (TAGGED/EXPIRED/CLEARED), CombatLogoutEvent
- PlayerTerritoryChangeEvent (territory entry/exit)
- PlayerPowerChangeEvent (DEATH/KILL/NEUTRAL_KILL/REGEN/COMBAT_LOGOUT/ADMIN)
- FactionChatEvent (FACTION/ALLY channels)
- FactionTransactionEvent (treasury operations)
- TeleportCancelledEvent (MOVED/DAMAGE/COMBAT_TAGGED/MANUAL)
- FactionInviteEvent, FactionJoinRequestEvent (CREATED/ACCEPTED/DECLINED/EXPIRED)
- ZoneCreateEvent, ZoneRemoveEvent
New cancellable pre-events:
- CombatTagPreEvent — prevent combat tagging
- FactionChatPreEvent — filter/block faction chat messages
- FactionTransactionPreEvent — block treasury transactions
- FactionHomeTeleportPreEvent — cancel /f home teleports
- FactionUnclaimPreEvent — prevent manual unclaims
Wired into: CombatTagManager, PowerManager, ChatManager, EconomyManager,
ClaimManager, TeleportManager, InviteManager, JoinRequestManager,
ZoneManager, TerritoryNotifier, TerritoryTickingSystem, HomeSubCommand
Updated API docs with complete event reference organized by system.
@derrickmehaffyderrickmehaffy
added
the 
enhancement
New feature or request
label
Mar 16, 2026
@derrickmehaffy
derrickmehaffy
merged commit 3328a81
into
releases/0.12.0Mar 16, 2026
@derrickmehaffy
derrickmehaffy
deleted the

feat/essentials-integration

branch
March 16, 2026 04:19
derrickmehaffy added a commit
that referenced
this pull request
Mar 16, 2026
@derrickmehaffy
docs: update documentation and changelog for 0.12.0 release
37b1bc0
Audit all docs against actual codebase and fix stale counts, missing
sections, and outdated references across 11 files.
CHANGELOG: add missing #106 (API expansion) and #107 (essentials
integration) entries. Architecture: update to 480 classes, 16 managers,
~46 subcommands, ~76 GUI pages, add missing packages (messages/,
economy/, importers). Config: migration chain v1→v8, add V7→V8 docs.
Protection zones: 57 flags with new pve_damage, interaction flags
(mount_use, light_use, npc/crate flags), transport mount_entry, and
essentials integration flags. Commands: remove nonexistent
AdminSentryHandler. Managers: add ChatHistoryManager to index and init
order. Storage: version and importer updates. API: JitPack v0.12.0.
README: remove Sentry rows, add BetterMap/HyperEssentials integrations,
update all counts. CurseForge: reduce per-bullet emoji density while
keeping section headers and semantic indicators.
@derrickmehaffyderrickmehaffy
mentioned this pull request
Mar 18, 2026
 Merged

86 tasks
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels

enhancementNew feature or request

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@derrickmehaffy

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
feat: essentials integration APIs and complete event coverage - #107
Merged
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Mar 16, 2026
Merged
feat: essentials integration APIs and complete event coverage#107
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Conversation
@derrickmehaffy
@derrickmehaffyderrickmehaffy
commented
Mar 16, 2026

Copy link


Copy Markdown

Contributor
Summary
  • Adds HyperEssentials integration APIs — faction home convenience methods, zone flag checking, ESSENTIALS_BACK zone flag, FactionHomeTeleportEvent
  • Completes event system with full coverage across all systems (16 new events wired into 12 managers)
  • Updates API documentation with complete event reference
Essentials Integration
  • hasFactionHome(), getFactionHomeWorld(), getFactionHomeCoords(), getFactionHomeCooldownRemaining() — stable API replacing reflection
  • isZoneFlagAllowed() for homes/warps/kits/back restrictions
  • FactionHomeTeleportEvent for both instant and warmup teleports
New Post-Events (10)
  • CombatTagEvent, CombatLogoutEvent, PlayerTerritoryChangeEvent, PlayerPowerChangeEvent
  • FactionChatEvent, FactionTransactionEvent, TeleportCancelledEvent
  • FactionInviteEvent, FactionJoinRequestEvent, ZoneCreateEvent, ZoneRemoveEvent
New Cancellable Pre-Events (6)
  • CombatTagPreEvent, FactionChatPreEvent, FactionTransactionPreEvent
  • FactionHomeTeleportPreEvent, FactionUnclaimPreEvent
Test plan
  • ./gradlew :HyperFactions:shadowJar builds successfully
  • ./gradlew :HyperFactions:test — 211 tests pass, 0 failures
  •  Deploy and verify territory change events fire on movement
  •  Verify combat tag events fire on PvP
  •  Verify faction chat pre-event cancellation
  •  Verify HyperEssentials back tracking via FactionHomeTeleportEvent
  •  Verify zone flag restrictions for homes/warps/kits/back
@derrickmehaffy
feat: essentials integration — API convenience methods, zone flag, an…
d107c67
…d teleport event
Add HyperFactionsAPI convenience methods for faction home queries and zone
flag checks so HyperEssentials can use stable API methods instead of direct
Faction class reflection:
- hasFactionHome(UUID), getFactionHomeWorld(UUID), getFactionHomeCoords(UUID)
- getFactionHomeCooldownRemaining(UUID)
- isZoneFlagAllowed(String, double, double, String)
Add ESSENTIALS_BACK zone flag alongside existing ESSENTIALS_HOMES/WARPS/KITS
for controlling /back teleport in zones. Defaults to allowed in both safe and
war zones.
Add FactionHomeTeleportEvent fired when a player teleports to faction home
(both instant and warmup-completed), enabling HyperEssentials to subscribe
via EventBus for back location tracking without coupling.
@derrickmehaffy
feat(events): complete event coverage — 16 new events across all systems
1454c11
New post-events:
- CombatTagEvent (TAGGED/EXPIRED/CLEARED), CombatLogoutEvent
- PlayerTerritoryChangeEvent (territory entry/exit)
- PlayerPowerChangeEvent (DEATH/KILL/NEUTRAL_KILL/REGEN/COMBAT_LOGOUT/ADMIN)
- FactionChatEvent (FACTION/ALLY channels)
- FactionTransactionEvent (treasury operations)
- TeleportCancelledEvent (MOVED/DAMAGE/COMBAT_TAGGED/MANUAL)
- FactionInviteEvent, FactionJoinRequestEvent (CREATED/ACCEPTED/DECLINED/EXPIRED)
- ZoneCreateEvent, ZoneRemoveEvent
New cancellable pre-events:
- CombatTagPreEvent — prevent combat tagging
- FactionChatPreEvent — filter/block faction chat messages
- FactionTransactionPreEvent — block treasury transactions
- FactionHomeTeleportPreEvent — cancel /f home teleports
- FactionUnclaimPreEvent — prevent manual unclaims
Wired into: CombatTagManager, PowerManager, ChatManager, EconomyManager,
ClaimManager, TeleportManager, InviteManager, JoinRequestManager,
ZoneManager, TerritoryNotifier, TerritoryTickingSystem, HomeSubCommand
Updated API docs with complete event reference organized by system.
@derrickmehaffyderrickmehaffy
added
the 
enhancement
New feature or request
label
Mar 16, 2026
@derrickmehaffy
derrickmehaffy
merged commit 3328a81
into
releases/0.12.0Mar 16, 2026
@derrickmehaffy
derrickmehaffy
deleted the

feat/essentials-integration

branch
March 16, 2026 04:19
derrickmehaffy added a commit
that referenced
this pull request
Mar 16, 2026
@derrickmehaffy
docs: update documentation and changelog for 0.12.0 release
37b1bc0
Audit all docs against actual codebase and fix stale counts, missing
sections, and outdated references across 11 files.
CHANGELOG: add missing #106 (API expansion) and #107 (essentials
integration) entries. Architecture: update to 480 classes, 16 managers,
~46 subcommands, ~76 GUI pages, add missing packages (messages/,
economy/, importers). Config: migration chain v1→v8, add V7→V8 docs.
Protection zones: 57 flags with new pve_damage, interaction flags
(mount_use, light_use, npc/crate flags), transport mount_entry, and
essentials integration flags. Commands: remove nonexistent
AdminSentryHandler. Managers: add ChatHistoryManager to index and init
order. Storage: version and importer updates. API: JitPack v0.12.0.
README: remove Sentry rows, add BetterMap/HyperEssentials integrations,
update all counts. CurseForge: reduce per-bullet emoji density while
keeping section headers and semantic indicators.
@derrickmehaffyderrickmehaffy
mentioned this pull request
Mar 18, 2026
 Merged

86 tasks
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels

enhancementNew feature or request

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@derrickmehaffy

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: essentials integration APIs and complete event coverage - #107
Merged
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Mar 16, 2026
Merged
feat: essentials integration APIs and complete event coverage#107
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Conversation
@derrickmehaffy
@derrickmehaffyderrickmehaffy
commented
Mar 16, 2026

Copy link


Copy Markdown

Contributor
Summary
  • Adds HyperEssentials integration APIs — faction home convenience methods, zone flag checking, ESSENTIALS_BACK zone flag, FactionHomeTeleportEvent
  • Completes event system with full coverage across all systems (16 new events wired into 12 managers)
  • Updates API documentation with complete event reference
Essentials Integration
  • hasFactionHome(), getFactionHomeWorld(), getFactionHomeCoords(), getFactionHomeCooldownRemaining() — stable API replacing reflection
  • isZoneFlagAllowed() for homes/warps/kits/back restrictions
  • FactionHomeTeleportEvent for both instant and warmup teleports
New Post-Events (10)
  • CombatTagEvent, CombatLogoutEvent, PlayerTerritoryChangeEvent, PlayerPowerChangeEvent
  • FactionChatEvent, FactionTransactionEvent, TeleportCancelledEvent
  • FactionInviteEvent, FactionJoinRequestEvent, ZoneCreateEvent, ZoneRemoveEvent
New Cancellable Pre-Events (6)
  • CombatTagPreEvent, FactionChatPreEvent, FactionTransactionPreEvent
  • FactionHomeTeleportPreEvent, FactionUnclaimPreEvent
Test plan
  • ./gradlew :HyperFactions:shadowJar builds successfully
  • ./gradlew :HyperFactions:test — 211 tests pass, 0 failures
  •  Deploy and verify territory change events fire on movement
  •  Verify combat tag events fire on PvP
  •  Verify faction chat pre-event cancellation
  •  Verify HyperEssentials back tracking via FactionHomeTeleportEvent
  •  Verify zone flag restrictions for homes/warps/kits/back
@derrickmehaffy
feat: essentials integration — API convenience methods, zone flag, an…
d107c67
…d teleport event
Add HyperFactionsAPI convenience methods for faction home queries and zone
flag checks so HyperEssentials can use stable API methods instead of direct
Faction class reflection:
- hasFactionHome(UUID), getFactionHomeWorld(UUID), getFactionHomeCoords(UUID)
- getFactionHomeCooldownRemaining(UUID)
- isZoneFlagAllowed(String, double, double, String)
Add ESSENTIALS_BACK zone flag alongside existing ESSENTIALS_HOMES/WARPS/KITS
for controlling /back teleport in zones. Defaults to allowed in both safe and
war zones.
Add FactionHomeTeleportEvent fired when a player teleports to faction home
(both instant and warmup-completed), enabling HyperEssentials to subscribe
via EventBus for back location tracking without coupling.
@derrickmehaffy
feat(events): complete event coverage — 16 new events across all systems
1454c11
New post-events:
- CombatTagEvent (TAGGED/EXPIRED/CLEARED), CombatLogoutEvent
- PlayerTerritoryChangeEvent (territory entry/exit)
- PlayerPowerChangeEvent (DEATH/KILL/NEUTRAL_KILL/REGEN/COMBAT_LOGOUT/ADMIN)
- FactionChatEvent (FACTION/ALLY channels)
- FactionTransactionEvent (treasury operations)
- TeleportCancelledEvent (MOVED/DAMAGE/COMBAT_TAGGED/MANUAL)
- FactionInviteEvent, FactionJoinRequestEvent (CREATED/ACCEPTED/DECLINED/EXPIRED)
- ZoneCreateEvent, ZoneRemoveEvent
New cancellable pre-events:
- CombatTagPreEvent — prevent combat tagging
- FactionChatPreEvent — filter/block faction chat messages
- FactionTransactionPreEvent — block treasury transactions
- FactionHomeTeleportPreEvent — cancel /f home teleports
- FactionUnclaimPreEvent — prevent manual unclaims
Wired into: CombatTagManager, PowerManager, ChatManager, EconomyManager,
ClaimManager, TeleportManager, InviteManager, JoinRequestManager,
ZoneManager, TerritoryNotifier, TerritoryTickingSystem, HomeSubCommand
Updated API docs with complete event reference organized by system.
@derrickmehaffyderrickmehaffy
added
the 
enhancement
New feature or request
label
Mar 16, 2026
@derrickmehaffy
derrickmehaffy
merged commit 3328a81
into
releases/0.12.0Mar 16, 2026
@derrickmehaffy
derrickmehaffy
deleted the

feat/essentials-integration

branch
March 16, 2026 04:19
derrickmehaffy added a commit
that referenced
this pull request
Mar 16, 2026
@derrickmehaffy
docs: update documentation and changelog for 0.12.0 release
37b1bc0
Audit all docs against actual codebase and fix stale counts, missing
sections, and outdated references across 11 files.
CHANGELOG: add missing #106 (API expansion) and #107 (essentials
integration) entries. Architecture: update to 480 classes, 16 managers,
~46 subcommands, ~76 GUI pages, add missing packages (messages/,
economy/, importers). Config: migration chain v1→v8, add V7→V8 docs.
Protection zones: 57 flags with new pve_damage, interaction flags
(mount_use, light_use, npc/crate flags), transport mount_entry, and
essentials integration flags. Commands: remove nonexistent
AdminSentryHandler. Managers: add ChatHistoryManager to index and init
order. Storage: version and importer updates. API: JitPack v0.12.0.
README: remove Sentry rows, add BetterMap/HyperEssentials integrations,
update all counts. CurseForge: reduce per-bullet emoji density while
keeping section headers and semantic indicators.
@derrickmehaffyderrickmehaffy
mentioned this pull request
Mar 18, 2026
 Merged

86 tasks
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels

enhancementNew feature or request

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@derrickmehaffy

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: essentials integration APIs and complete event coverage - #107
Merged
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Mar 16, 2026
Merged
feat: essentials integration APIs and complete event coverage#107
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Conversation
@derrickmehaffy
@derrickmehaffyderrickmehaffy
commented
Mar 16, 2026

Copy link


Copy Markdown

Contributor
Summary
  • Adds HyperEssentials integration APIs — faction home convenience methods, zone flag checking, ESSENTIALS_BACK zone flag, FactionHomeTeleportEvent
  • Completes event system with full coverage across all systems (16 new events wired into 12 managers)
  • Updates API documentation with complete event reference
Essentials Integration
  • hasFactionHome(), getFactionHomeWorld(), getFactionHomeCoords(), getFactionHomeCooldownRemaining() — stable API replacing reflection
  • isZoneFlagAllowed() for homes/warps/kits/back restrictions
  • FactionHomeTeleportEvent for both instant and warmup teleports
New Post-Events (10)
  • CombatTagEvent, CombatLogoutEvent, PlayerTerritoryChangeEvent, PlayerPowerChangeEvent
  • FactionChatEvent, FactionTransactionEvent, TeleportCancelledEvent
  • FactionInviteEvent, FactionJoinRequestEvent, ZoneCreateEvent, ZoneRemoveEvent
New Cancellable Pre-Events (6)
  • CombatTagPreEvent, FactionChatPreEvent, FactionTransactionPreEvent
  • FactionHomeTeleportPreEvent, FactionUnclaimPreEvent
Test plan
  • ./gradlew :HyperFactions:shadowJar builds successfully
  • ./gradlew :HyperFactions:test — 211 tests pass, 0 failures
  •  Deploy and verify territory change events fire on movement
  •  Verify combat tag events fire on PvP
  •  Verify faction chat pre-event cancellation
  •  Verify HyperEssentials back tracking via FactionHomeTeleportEvent
  •  Verify zone flag restrictions for homes/warps/kits/back
@derrickmehaffy
feat: essentials integration — API convenience methods, zone flag, an…
d107c67
…d teleport event
Add HyperFactionsAPI convenience methods for faction home queries and zone
flag checks so HyperEssentials can use stable API methods instead of direct
Faction class reflection:
- hasFactionHome(UUID), getFactionHomeWorld(UUID), getFactionHomeCoords(UUID)
- getFactionHomeCooldownRemaining(UUID)
- isZoneFlagAllowed(String, double, double, String)
Add ESSENTIALS_BACK zone flag alongside existing ESSENTIALS_HOMES/WARPS/KITS
for controlling /back teleport in zones. Defaults to allowed in both safe and
war zones.
Add FactionHomeTeleportEvent fired when a player teleports to faction home
(both instant and warmup-completed), enabling HyperEssentials to subscribe
via EventBus for back location tracking without coupling.
@derrickmehaffy
feat(events): complete event coverage — 16 new events across all systems
1454c11
New post-events:
- CombatTagEvent (TAGGED/EXPIRED/CLEARED), CombatLogoutEvent
- PlayerTerritoryChangeEvent (territory entry/exit)
- PlayerPowerChangeEvent (DEATH/KILL/NEUTRAL_KILL/REGEN/COMBAT_LOGOUT/ADMIN)
- FactionChatEvent (FACTION/ALLY channels)
- FactionTransactionEvent (treasury operations)
- TeleportCancelledEvent (MOVED/DAMAGE/COMBAT_TAGGED/MANUAL)
- FactionInviteEvent, FactionJoinRequestEvent (CREATED/ACCEPTED/DECLINED/EXPIRED)
- ZoneCreateEvent, ZoneRemoveEvent
New cancellable pre-events:
- CombatTagPreEvent — prevent combat tagging
- FactionChatPreEvent — filter/block faction chat messages
- FactionTransactionPreEvent — block treasury transactions
- FactionHomeTeleportPreEvent — cancel /f home teleports
- FactionUnclaimPreEvent — prevent manual unclaims
Wired into: CombatTagManager, PowerManager, ChatManager, EconomyManager,
ClaimManager, TeleportManager, InviteManager, JoinRequestManager,
ZoneManager, TerritoryNotifier, TerritoryTickingSystem, HomeSubCommand
Updated API docs with complete event reference organized by system.
@derrickmehaffyderrickmehaffy
added
the 
enhancement
New feature or request
label
Mar 16, 2026
@derrickmehaffy
derrickmehaffy
merged commit 3328a81
into
releases/0.12.0Mar 16, 2026
@derrickmehaffy
derrickmehaffy
deleted the

feat/essentials-integration

branch
March 16, 2026 04:19
derrickmehaffy added a commit
that referenced
this pull request
Mar 16, 2026
@derrickmehaffy
docs: update documentation and changelog for 0.12.0 release
37b1bc0
Audit all docs against actual codebase and fix stale counts, missing
sections, and outdated references across 11 files.
CHANGELOG: add missing #106 (API expansion) and #107 (essentials
integration) entries. Architecture: update to 480 classes, 16 managers,
~46 subcommands, ~76 GUI pages, add missing packages (messages/,
economy/, importers). Config: migration chain v1→v8, add V7→V8 docs.
Protection zones: 57 flags with new pve_damage, interaction flags
(mount_use, light_use, npc/crate flags), transport mount_entry, and
essentials integration flags. Commands: remove nonexistent
AdminSentryHandler. Managers: add ChatHistoryManager to index and init
order. Storage: version and importer updates. API: JitPack v0.12.0.
README: remove Sentry rows, add BetterMap/HyperEssentials integrations,
update all counts. CurseForge: reduce per-bullet emoji density while
keeping section headers and semantic indicators.
@derrickmehaffyderrickmehaffy
mentioned this pull request
Mar 18, 2026
 Merged

86 tasks
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels

enhancementNew feature or request

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@derrickmehaffy

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
feat: essentials integration APIs and complete event coverage - #107
Merged
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Mar 16, 2026
Merged
feat: essentials integration APIs and complete event coverage#107
derrickmehaffy merged 2 commits into
releases/0.12.0from 
feat/essentials-integration
Conversation
@derrickmehaffy
@derrickmehaffyderrickmehaffy
commented
Mar 16, 2026

Copy link


Copy Markdown

Contributor
Summary
  • Adds HyperEssentials integration APIs — faction home convenience methods, zone flag checking, ESSENTIALS_BACK zone flag, FactionHomeTeleportEvent
  • Completes event system with full coverage across all systems (16 new events wired into 12 managers)
  • Updates API documentation with complete event reference
Essentials Integration
  • hasFactionHome(), getFactionHomeWorld(), getFactionHomeCoords(), getFactionHomeCooldownRemaining() — stable API replacing reflection
  • isZoneFlagAllowed() for homes/warps/kits/back restrictions
  • FactionHomeTeleportEvent for both instant and warmup teleports
New Post-Events (10)
  • CombatTagEvent, CombatLogoutEvent, PlayerTerritoryChangeEvent, PlayerPowerChangeEvent
  • FactionChatEvent, FactionTransactionEvent, TeleportCancelledEvent
  • FactionInviteEvent, FactionJoinRequestEvent, ZoneCreateEvent, ZoneRemoveEvent
New Cancellable Pre-Events (6)
  • CombatTagPreEvent, FactionChatPreEvent, FactionTransactionPreEvent
  • FactionHomeTeleportPreEvent, FactionUnclaimPreEvent
Test plan
  • ./gradlew :HyperFactions:shadowJar builds successfully
  • ./gradlew :HyperFactions:test — 211 tests pass, 0 failures
  •  Deploy and verify territory change events fire on movement
  •  Verify combat tag events fire on PvP
  •  Verify faction chat pre-event cancellation
  •  Verify HyperEssentials back tracking via FactionHomeTeleportEvent
  •  Verify zone flag restrictions for homes/warps/kits/back
@derrickmehaffy
feat: essentials integration — API convenience methods, zone flag, an…
d107c67
…d teleport event
Add HyperFactionsAPI convenience methods for faction home queries and zone
flag checks so HyperEssentials can use stable API methods instead of direct
Faction class reflection:
- hasFactionHome(UUID), getFactionHomeWorld(UUID), getFactionHomeCoords(UUID)
- getFactionHomeCooldownRemaining(UUID)
- isZoneFlagAllowed(String, double, double, String)
Add ESSENTIALS_BACK zone flag alongside existing ESSENTIALS_HOMES/WARPS/KITS
for controlling /back teleport in zones. Defaults to allowed in both safe and
war zones.
Add FactionHomeTeleportEvent fired when a player teleports to faction home
(both instant and warmup-completed), enabling HyperEssentials to subscribe
via EventBus for back location tracking without coupling.
@derrickmehaffy
feat(events): complete event coverage — 16 new events across all systems
1454c11
New post-events:
- CombatTagEvent (TAGGED/EXPIRED/CLEARED), CombatLogoutEvent
- PlayerTerritoryChangeEvent (territory entry/exit)
- PlayerPowerChangeEvent (DEATH/KILL/NEUTRAL_KILL/REGEN/COMBAT_LOGOUT/ADMIN)
- FactionChatEvent (FACTION/ALLY channels)
- FactionTransactionEvent (treasury operations)
- TeleportCancelledEvent (MOVED/DAMAGE/COMBAT_TAGGED/MANUAL)
- FactionInviteEvent, FactionJoinRequestEvent (CREATED/ACCEPTED/DECLINED/EXPIRED)
- ZoneCreateEvent, ZoneRemoveEvent
New cancellable pre-events:
- CombatTagPreEvent — prevent combat tagging
- FactionChatPreEvent — filter/block faction chat messages
- FactionTransactionPreEvent — block treasury transactions
- FactionHomeTeleportPreEvent — cancel /f home teleports
- FactionUnclaimPreEvent — prevent manual unclaims
Wired into: CombatTagManager, PowerManager, ChatManager, EconomyManager,
ClaimManager, TeleportManager, InviteManager, JoinRequestManager,
ZoneManager, TerritoryNotifier, TerritoryTickingSystem, HomeSubCommand
Updated API docs with complete event reference organized by system.
@derrickmehaffyderrickmehaffy
added
the 
enhancement
New feature or request
label
Mar 16, 2026
@derrickmehaffy
derrickmehaffy
merged commit 3328a81
into
releases/0.12.0Mar 16, 2026
@derrickmehaffy
derrickmehaffy
deleted the

feat/essentials-integration

branch
March 16, 2026 04:19
derrickmehaffy added a commit
that referenced
this pull request
Mar 16, 2026
@derrickmehaffy
docs: update documentation and changelog for 0.12.0 release
37b1bc0
Audit all docs against actual codebase and fix stale counts, missing
sections, and outdated references across 11 files.
CHANGELOG: add missing #106 (API expansion) and #107 (essentials
integration) entries. Architecture: update to 480 classes, 16 managers,
~46 subcommands, ~76 GUI pages, add missing packages (messages/,
economy/, importers). Config: migration chain v1→v8, add V7→V8 docs.
Protection zones: 57 flags with new pve_damage, interaction flags
(mount_use, light_use, npc/crate flags), transport mount_entry, and
essentials integration flags. Commands: remove nonexistent
AdminSentryHandler. Managers: add ChatHistoryManager to index and init
order. Storage: version and importer updates. API: JitPack v0.12.0.
README: remove Sentry rows, add BetterMap/HyperEssentials integrations,
update all counts. CurseForge: reduce per-bullet emoji density while
keeping section headers and semantic indicators.
@derrickmehaffyderrickmehaffy
mentioned this pull request
Mar 18, 2026
 Merged

86 tasks
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels

enhancementNew feature or request

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@derrickmehaffy