Update version number to 7.1.1

Fix queued proxy votes being rejected by vote delay

.gitattributes

@@ -1 +0,0 @@
-.gitea/CODEOWNERS linguist-detectable=false

.gitea/CODEOWNERS

@@ -1,3 +0,0 @@
-# Pull requests request review from the eligible staff team(s).
-# One approval from either an Admin or Developer satisfies branch protection.
-*   @trueog/Admins @trueog/Developers

.github/FUNDING.yml

@@ -0,0 +1,14 @@
+# These are supported funding model platforms
+
+github: BenCodez # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+#patreon: # Replace with a single Patreon username
+#open_collective: # Replace with a single Open Collective username
+#ko_fi: # Replace with a single Ko-fi username
+#tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+#community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+#liberapay: # Replace with a single Liberapay username
+#issuehunt: # Replace with a single IssueHunt username
+#lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+#polar: # Replace with a single Polar username
+#buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+custom: ["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=YQBX25RTXJ5DG"]

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,30 @@
+---
+name: Bug report
+about: Bug report for VotingPlugin
+title: ''
+labels: Possible Bug
+assignees: ''
+
+---
+
+**Versions**
+Plugin version and spigot version.
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots/Configs**
+If applicable, add screenshots to help explain your problem and/or configs relating to the issue.
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea
+title: ''
+labels: Possible Feature
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/question-concerns.md

@@ -0,0 +1,17 @@
+---
+name: Question/Concerns
+about: Ask about a question or a concern about the plugin
+title: ''
+labels: Question/Concern
+assignees: ''
+
+---
+
+**Versions**
+Plugin version and spigot version
+
+**Relevant information**
+Configs that relate to the issue in a pastebin.
+
+**Context**
+Context about the question/concern

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "maven" # See documentation for possible values
+    directory: "/VotingPlugin/" # Location of package manifests
+    schedule:
+      interval: "weekly"

.github/workflows/maven.yml

@@ -0,0 +1,41 @@
+# This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-java-with-maven
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support documentation.
+
+name: Java CI with Maven
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+
+permissions:
+  contents: write   # required for dependency submission
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: maven
+
+      - name: Build with Maven
+        run: mvn -B -f VotingPlugin/pom.xml package
+
+      # Only submit dependency snapshot on push (not on pull_request)
+      - name: Submit Dependency Snapshot
+        if: github.event_name == 'push'
+        uses: advanced-security/maven-dependency-submission-action@v5
+        with:
+          directory: VotingPlugin   # path to pom.xml
+          # optional: maven-args: "-DskipTests"

.github/workflows/publish-javadoc.yml

@@ -0,0 +1,24 @@
+name: Deploy Javadoc
+
+on:
+  release:
+    types: [published]
+    branches:
+      - master
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy JavaDoc 🚀
+        uses: MathieuSoysal/Javadoc-publisher.yml@main
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          javadoc-branch: gh-pages
+          java-version: 21
+          target-folder: ''
+          project: maven # or gradle
+          # subdirectories: moduleA moduleB #for subdirectories support, needs to be run with custom command
+          custom-command: mvn -f VotingPlugin/pom.xml deploy -P javadoc javadoc:aggregate
+          javadoc-source-folder: 'VotingPlugin/target/reports/apidocs'

.github/workflows/stale.yml

@@ -0,0 +1,27 @@
+# This workflow warns and then closes issues and PRs that have had no activity for a specified amount of time.
+#
+# You can adjust the behavior by modifying this file.
+# For more information, see:
+# https://github.com/actions/stale
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: '19 16 * * *'
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+
+    steps:
+    - uses: actions/stale@v5
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'Stale issue message'
+        stale-pr-message: 'Stale pull request message'
+        stale-issue-label: 'no-issue-activity'
+        stale-pr-label: 'no-pr-activity'

.gitignore

@@ -1,5 +0,0 @@
-.gradle/
-.classpath
-.project
-.settings/
-build/

VotingPlugin/.github/agents/test.agent.md

@@ -0,0 +1,5 @@
+---
+description: Describe what this custom agent does and when to use it.
+tools: []
+---
+Write instructions for this custom agent. These will guide Copilot on how to respond when this mode is selected.

VotingPlugin/.gitignore

@@ -0,0 +1,9 @@
+/bin/
+/target/
+/doc/
+/.idea/
+/*.iml
+/.settings/
+/.classpath
+/.factorypath
+/.apt_generated_tests/

VotingPlugin/.project

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>VotingPlugin</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.m2e.core.maven2Builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.wst.validation.validationbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.m2e.core.maven2Builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.m2e.core.maven2Nature</nature>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+</projectDescription>

VotingPlugin/pom.xml

@@ -0,0 +1,663 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>com.bencodez</groupId>
+    <artifactId>votingplugin</artifactId>
+    <version>7.1.1</version>
+    <packaging>jar</packaging>
+    <name>VotingPlugin</name>
+    <properties>
+        <github.global.server>github</github.global.server>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <build.number>NOTSET</build.number>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <maven.compiler.release>21</maven.compiler.release>
+        <velocity.version>3.4.0</velocity.version>
+    </properties>
+    <build>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+                <includes>
+                    <include>plugin.yml</include>
+                    <include>bungee.yml</include>
+                    <include>votingpluginversion.yml</include>
+                </includes>
+            </resource>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>false</filtering>
+                <excludes>
+                    <exclude>plugin.yml</exclude>
+                    <exclude>bungee.yml</exclude>
+                    <exclude>votingpluginversion.yml</exclude>
+                </excludes>
+            </resource>
+        </resources>
+        <sourceDirectory>src/main/java</sourceDirectory>
+        <testSourceDirectory>src/test/java</testSourceDirectory>
+        <pluginManagement>
+            <plugins>
+                <plugin>
+                    <groupId>org.eclipse.m2e</groupId>
+                    <artifactId>lifecycle-mapping</artifactId>
+                    <version>1.0.0</version>
+                    <configuration>
+                        <lifecycleMappingMetadata>
+                            <pluginExecutions>
+                                <pluginExecution>
+                                    <pluginExecutionFilter>
+                                        <groupId>org.projectlombok</groupId>
+                                        <artifactId>lombok-maven-plugin</artifactId>
+                                        <versionRange>[1,)</versionRange>
+                                        <goals>
+                                            <goal>delombok</goal>
+                                        </goals>
+                                    </pluginExecutionFilter>
+                                    <action>
+                                        <ignore />
+                                    </action>
+                                </pluginExecution>
+                            </pluginExecutions>
+                        </lifecycleMappingMetadata>
+                    </configuration>
+                </plugin>
+            </plugins>
+        </pluginManagement>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.13.0</version>
+                <configuration>
+                    <release>21</release>
+                    <annotationProcessorPaths>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                            <version>1.18.42</version>
+                        </path>
+                        <path>
+                            <groupId>com.velocitypowered</groupId>
+                            <artifactId>velocity-api</artifactId>
+                            <version>${velocity.version}</version>
+                        </path>
+                    </annotationProcessorPaths>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <version>3.6.2</version>
+                <configuration>
+                    <shadedArtifactAttached>false</shadedArtifactAttached>
+                    <minimizeJar>false</minimizeJar>
+                    <filters>
+                        <filter>
+                            <artifact>mysql-connector-java</artifact>
+                            <includes>
+                                <include>**</include>
+                            </includes>
+                        </filter>
+                        <filter>
+                            <artifact>*:*</artifact>
+                            <excludes>
+                                <exclude>META-INF/*.SF</exclude>
+                                <exclude>META-INF/*.DSA</exclude>
+                                <exclude>META-INF/*.RSA</exclude>
+                            </excludes>
+                        </filter>
+                    </filters>
+                    <relocations>
+                        <relocation>
+                            <pattern>com.tcoded.folialib</pattern>
+                            <shadedPattern>
+                                ${project.groupId}.votingplugin.simpleapi.folialib</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>com.bencodez.simpleapi</pattern>
+                            <shadedPattern>
+                                ${project.groupId}.votingplugin.simpleapi</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>com.bencodez.advancedcore</pattern>
+                            <shadedPattern>
+                                ${project.groupId}.votingplugin.advancedcore</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>net.pl3x.bukkit.chatapi</pattern>
+                            <shadedPattern>${project.groupId}.votingplugin</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>me.mrten.mysqlapi</pattern>
+                            <shadedPattern>
+                                ${project.groupId}.votingplugin.mysqlapi</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>com.zaxxer.hikari</pattern>
+                            <shadedPattern>${project.groupId}.votingplugin.simpleapi.hikari</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>org.bstats</pattern>
+                            <shadedPattern>
+                                ${project.groupId}.votingplugin.bstats</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>xyz.upperlevel.spigot</pattern>
+                            <shadedPattern>
+                                ${project.groupId}.votingplugin.advancedcore.xyz.upperlevel.spigot</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>org.spongepowered.configurate</pattern>
+                            <shadedPattern>${project.groupId}.simpleapi.configurate</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>io.leangen.geantyref</pattern>
+                            <shadedPattern>${project.groupId}.simpleapi.geantyref</shadedPattern>
+                        </relocation>
+                    </relocations>
+                </configuration>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                        <configuration>
+                            <artifactSet>
+                                <!-- Lets exclude google code, because the
+								server already has this 
+									code in it (guava, etc) -->
+                                <excludes>
+                                    <exclude>com.google.*:*</exclude>
+                                </excludes>
+                            </artifactSet>
+                            <minimizeJar>false</minimizeJar>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                            <filters>
+                                <filter>
+                                    <artifact>*:*</artifact>
+                                    <excludes>
+                                        <exclude>META-INF/*.SF</exclude>
+                                        <exclude>META-INF/*.DSA</exclude>
+                                        <exclude>META-INF/*.RSA</exclude>
+                                        <exclude>module-info.class</exclude>
+                                    </excludes>
+                                </filter>
+                            </filters>
+                            <transformers>
+                                <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer" />
+                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer" />
+                            </transformers>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+    <repositories>
+        <repository>
+            <id>spigot-repo</id>
+            <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
+        </repository>
+        <repository>
+            <id>maven-central</id>
+            <url>https://oss.sonatype.org/content/groups/public</url>
+        </repository>
+        <repository>
+            <id>bungeecord-repo</id>
+            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
+        </repository>
+        <repository>
+            <id>velocity</id>
+            <url>https://nexus.velocitypowered.com/repository/maven-public/</url>
+        </repository>
+        <repository>
+            <id>bencodez repo</id>
+            <url>https://nexus.bencodez.com/repository/maven-public/</url>
+        </repository>
+        <repository>
+            <id>papermc</id>
+            <url>https://repo.papermc.io/repository/maven-public/</url>
+        </repository>
+        <repository>
+            <id>placeholderapi</id>
+            <url>
+                https://repo.extendedclip.com/content/repositories/placeholderapi/</url>
+        </repository>
+        <repository>
+            <id>scarsz</id>
+            <url>https://nexus.scarsz.me/content/groups/public/</url>
+        </repository>
+    </repositories>
+    <dependencies>
+        <dependency>
+            <groupId>org.spigotmc</groupId>
+            <artifactId>spigot-api</artifactId>
+            <version>26.2-R0.1-SNAPSHOT</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <version>1.18.42</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>net.md-5</groupId>
+            <artifactId>bungeecord-api</artifactId>
+            <version>1.21-R0.4</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.vexsoftware</groupId>
+            <artifactId>nuvotifier-universal</artifactId>
+            <version>2.7.2</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>be.maximvdw</groupId>
+            <artifactId>mvdwplaceholderapi</artifactId>
+            <version>3.1.1</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.velocitypowered</groupId>
+            <artifactId>velocity-api</artifactId>
+            <version>${velocity.version}</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.bstats</groupId>
+            <artifactId>bstats-velocity</artifactId>
+            <version>3.2.1</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>me.clip</groupId>
+            <artifactId>placeholderapi</artifactId>
+            <version>2.12.2</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.bencodez</groupId>
+            <artifactId>advancedcore</artifactId>
+            <version>3.8.2-SNAPSHOT</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <version>5.12.2</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-core</artifactId>
+            <version>5.21.0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <version>5.12.2</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-junit-jupiter</artifactId>
+            <version>5.23.0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.discordsrv</groupId>
+            <artifactId>discordsrv</artifactId>
+            <version>1.30.4</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.spongepowered</groupId>
+            <artifactId>configurate-core</artifactId>
+            <version>4.2.0</version>
+        </dependency>
+        <dependency>
+            <groupId>org.spongepowered</groupId>
+            <artifactId>configurate-yaml</artifactId>
+            <version>4.2.0</version>
+        </dependency>
+        <dependency>
+            <groupId>org.spongepowered</groupId>
+            <artifactId>configurate-gson</artifactId>
+            <version>4.2.0</version>
+        </dependency>
+    </dependencies>
+    <profiles>
+        <profile>
+            <id>default</id>
+            <properties>
+                <build.profile.id>default</build.profile.id>
+            </properties>
+            <activation>
+                <activeByDefault>true</activeByDefault>
+            </activation>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-jar-plugin</artifactId>
+                        <version>3.5.0</version>
+                        <configuration>
+                            <archive>
+                                <manifestEntries>
+                                    <paperweight-mappings-namespace>mojang</paperweight-mappings-namespace>
+                                </manifestEntries>
+                            </archive>
+                            <finalName>${project.name}</finalName>
+                        </configuration>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+        <profile>
+            <id>deploy-snapshot</id>
+            <properties>
+                <build.profile.id>dev-snapshot</build.profile.id>
+            </properties>
+            <distributionManagement>
+                <snapshotRepository>
+                    <id>nexus</id>
+                    <url>https://nexus.bencodez.com/repository/maven-snapshots/</url>
+                </snapshotRepository>
+                <repository>
+                    <id>nexus</id>
+                    <url>https://nexus.bencodez.com/repository/maven-releases/</url>
+                </repository>
+            </distributionManagement>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-jar-plugin</artifactId>
+                        <version>3.5.0</version>
+                        <configuration>
+                            <archive>
+                                <manifestEntries>
+                                    <paperweight-mappings-namespace>mojang</paperweight-mappings-namespace>
+                                </manifestEntries>
+                            </archive>
+                            <finalName>
+                                ${project.name}-${build.number}</finalName>
+                        </configuration>
+                    </plugin>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-javadoc-plugin</artifactId>
+                        <version>3.12.0</version>
+                        <executions>
+                            <execution>
+                                <id>attach-javadocs</id>
+                                <goals>
+                                    <goal>jar</goal>
+                                </goals>
+                                <phase>deploy</phase>
+                                <configuration>
+                                    <failOnError>false</failOnError>
+                                    <doclint>none</doclint>
+                                    <sourcepath>
+                                        ${project.basedir}/target/delombok</sourcepath>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-deploy-plugin</artifactId>
+                        <version>3.1.4</version>
+                        <configuration>
+                            <skip>true</skip>
+                        </configuration>
+                    </plugin>
+                    <plugin>
+                        <groupId>org.sonatype.plugins</groupId>
+                        <artifactId>nexus-staging-maven-plugin</artifactId>
+                        <version>1.7.0</version>
+                        <executions>
+                            <execution>
+                                <id>default-deploy</id>
+                                <phase>deploy</phase>
+                                <goals>
+                                    <goal>deploy</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                        <configuration>
+                            <serverId>nexus</serverId>
+                            <nexusUrl>https://nexus.bencodez.com/nexus/</nexusUrl>
+                            <skipStaging>true</skipStaging>
+                        </configuration>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+        <profile>
+            <id>javadoc</id>
+            <properties>
+                <build.profile.id>javadoc</build.profile.id>
+            </properties>
+            <distributionManagement>
+                <repository>
+                    <id>internal.repo</id>
+                    <name>Temporary Staging Repository</name>
+                    <url>file://${project.build.directory}/mvn-repo</url>
+                </repository>
+            </distributionManagement>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-jar-plugin</artifactId>
+                        <version>3.5.0</version>
+                        <configuration>
+                            <archive>
+                                <manifestEntries>
+                                    <paperweight-mappings-namespace>mojang</paperweight-mappings-namespace>
+                                </manifestEntries>
+                            </archive>
+                            <finalName>${project.name}</finalName>
+                        </configuration>
+                    </plugin>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-javadoc-plugin</artifactId>
+                        <version>3.12.0</version>
+                        <executions>
+                            <execution>
+                                <id>attach-javadocs</id>
+                                <goals>
+                                    <goal>jar</goal>
+                                </goals>
+                                <phase>deploy</phase>
+                                <configuration>
+                                    <sourcepath>
+                                        ${project.basedir}/target/delombok</sourcepath>
+                                    <outputDirectory>
+                                        ${project.basedir}/target/apidocs</outputDirectory>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                    <plugin>
+                        <groupId>com.coderplus.maven.plugins</groupId>
+                        <artifactId>copy-rename-maven-plugin</artifactId>
+                        <version>1.0.1</version>
+                        <executions>
+                            <execution>
+                                <id>copy-file</id>
+                                <phase>deploy</phase>
+                                <goals>
+                                    <goal>copy</goal>
+                                </goals>
+                                <configuration>
+                                    <sourceFile>
+                                        ${project.basedir}/target/${project.name}.jar</sourceFile>
+                                    <destinationFile>
+                                        ${project.basedir}/target/${project.name}-${project.version}.jar</destinationFile>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+        <profile>
+            <id>dev</id>
+            <properties>
+                <build.profile.id>dev</build.profile.id>
+            </properties>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-jar-plugin</artifactId>
+                        <version>3.5.0</version>
+                        <configuration>
+                            <archive>
+                                <manifestEntries>
+                                    <paperweight-mappings-namespace>mojang</paperweight-mappings-namespace>
+                                </manifestEntries>
+                            </archive>
+                            <finalName>${project.name}</finalName>
+                        </configuration>
+                    </plugin>
+                    <plugin>
+                        <artifactId>maven-resources-plugin</artifactId>
+                        <version>3.4.0</version>
+                        <executions>
+                            <execution>
+                                <id>copy-resources</id>
+                                <phase>install</phase>
+                                <goals>
+                                    <goal>copy-resources</goal>
+                                </goals>
+                                <configuration>
+                                    <outputDirectory>
+                                        ${user.home}/Documents/Test_Server/plugins</outputDirectory>
+                                    <resources>
+                                        <resource>
+                                            <directory>${basedir}/target</directory>
+                                            <includes>
+                                                <include>VotingPlugin.jar</include>
+                                            </includes>
+                                        </resource>
+                                    </resources>
+                                    <overwrite>true</overwrite>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+        <profile>
+            <id>deploy</id>
+            <properties>
+                <build.profile.id>deploy</build.profile.id>
+            </properties>
+            <distributionManagement>
+                <snapshotRepository>
+                    <id>nexus</id>
+                    <url>https://nexus.bencodez.com/repository/maven-snapshots/</url>
+                </snapshotRepository>
+                <repository>
+                    <id>nexus</id>
+                    <url>https://nexus.bencodez.com/repository/maven-releases/</url>
+                </repository>
+            </distributionManagement>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-jar-plugin</artifactId>
+                        <version>3.5.0</version>
+                        <configuration>
+                            <archive>
+                                <manifestEntries>
+                                    <paperweight-mappings-namespace>mojang</paperweight-mappings-namespace>
+                                </manifestEntries>
+                            </archive>
+                            <finalName>${project.name}</finalName>
+                        </configuration>
+                    </plugin>
+                    <plugin>
+                        <groupId>com.coderplus.maven.plugins</groupId>
+                        <artifactId>copy-rename-maven-plugin</artifactId>
+                        <version>1.0.1</version>
+                        <executions>
+                            <execution>
+                                <id>copy-file</id>
+                                <phase>deploy</phase>
+                                <goals>
+                                    <goal>copy</goal>
+                                </goals>
+                                <configuration>
+                                    <sourceFile>
+                                        ${project.basedir}/target/${project.name}.jar</sourceFile>
+                                    <destinationFile>
+                                        ${project.basedir}/target/${project.name}-${project.version}.jar</destinationFile>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-javadoc-plugin</artifactId>
+                        <version>3.12.0</version>
+                        <executions>
+                            <execution>
+                                <id>attach-javadocs</id>
+                                <goals>
+                                    <goal>jar</goal>
+                                </goals>
+                                <phase>deploy</phase>
+                                <configuration>
+                                    <sourcepath>
+                                        ${project.basedir}/target/delombok</sourcepath>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-deploy-plugin</artifactId>
+                        <version>3.1.4</version>
+                        <configuration>
+                            <skip>true</skip>
+                        </configuration>
+                    </plugin>
+                    <plugin>
+                        <groupId>org.sonatype.plugins</groupId>
+                        <artifactId>nexus-staging-maven-plugin</artifactId>
+                        <version>1.7.0</version>
+                        <executions>
+                            <execution>
+                                <id>default-deploy</id>
+                                <phase>deploy</phase>
+                                <goals>
+                                    <goal>deploy</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                        <configuration>
+                            <serverId>nexus</serverId>
+                            <nexusUrl>https://nexus.bencodez.com/nexus/</nexusUrl>
+                            <skipStaging>true</skipStaging>
+                        </configuration>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+    </profiles>
+</project>

VotingPlugin/src/main/java/com/bencodez/votingplugin/BungeeHandler.java

@@ -0,0 +1,787 @@
+// File: com/bencodez/votingplugin/BungeeHandler.java
+package com.bencodez.votingplugin;
+
+import java.io.File;
+import java.sql.SQLException;
+import java.time.LocalDateTime;
+import java.time.ZoneOffset;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.Executors;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.Listener;
+import org.eclipse.paho.client.mqttv3.MqttException;
+
+import com.bencodez.advancedcore.api.misc.MiscUtils;
+import com.bencodez.advancedcore.api.rewards.RewardBuilder;
+import com.bencodez.advancedcore.api.time.TimeType;
+import com.bencodez.advancedcore.api.user.UserStorage;
+import com.bencodez.advancedcore.bungeeapi.globaldata.GlobalDataHandler;
+import com.bencodez.advancedcore.bungeeapi.globaldata.GlobalMySQL;
+import com.bencodez.simpleapi.encryption.EncryptionHandler;
+import com.bencodez.simpleapi.servercomm.codec.JsonEnvelope;
+import com.bencodez.simpleapi.servercomm.global.GlobalMessageHandler;
+import com.bencodez.simpleapi.servercomm.global.GlobalMessageListener;
+import com.bencodez.simpleapi.servercomm.mqtt.MqttHandler;
+import com.bencodez.simpleapi.servercomm.mqtt.MqttServerComm;
+import com.bencodez.simpleapi.servercomm.mysql.MySqlMessenger;
+import com.bencodez.simpleapi.servercomm.pluginmessage.PluginMessageHandler;
+import com.bencodez.simpleapi.servercomm.redis.RedisHandler;
+import com.bencodez.simpleapi.servercomm.redis.RedisListener;
+import com.bencodez.simpleapi.servercomm.sockets.ClientHandler;
+import com.bencodez.simpleapi.servercomm.sockets.SocketHandler;
+import com.bencodez.simpleapi.servercomm.sockets.SocketReceiver;
+import com.bencodez.simpleapi.sql.data.DataValue;
+import com.bencodez.simpleapi.sql.data.DataValueBoolean;
+import com.bencodez.simpleapi.sql.mysql.config.MysqlConfigSpigot;
+import com.bencodez.votingplugin.proxy.BungeeMethod;
+import com.bencodez.votingplugin.proxy.VoteTotalsSnapshot;
+import com.bencodez.votingplugin.proxy.VotingPluginWire;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
+
+import lombok.Getter;
+
+/**
+ * Handler for Bungee/proxy server integration.
+ */
+public class BungeeHandler implements Listener {
+
+	private static final long PROCESSED_VOTE_TTL_MILLIS = TimeUnit.MINUTES.toMillis(30);
+
+	@Getter
+	private final ConcurrentHashMap<UUID, Long> processedWireVotes = new ConcurrentHashMap<>();
+	@Getter
+	private ClientHandler clientHandler;
+
+	private EncryptionHandler encryptionHandler;
+
+	@Getter
+	private BungeeMethod method;
+
+	private VotingPluginMain plugin;
+
+	@Getter
+	private int bungeeVotePartyCurrent = -2;
+
+	@Getter
+	private int bungeeVotePartyRequired = -2;
+
+	@Getter
+	private SocketHandler socketHandler;
+
+	private GlobalDataHandler globalDataHandler;
+
+	@Getter
+	private ScheduledExecutorService timer;
+
+	@Getter
+	private RedisHandler redisHandler;
+
+	@Getter
+	private GlobalMessageHandler globalMessageHandler;
+
+	private Thread redisThread;
+
+	@Getter
+	private MySqlMessenger backendMysqlMessenger;
+
+	@Getter
+	private MqttHandler mqttHandler;
+
+	/**
+	 * Constructs a new BungeeHandler.
+	 *
+	 * @param plugin the main plugin instance
+	 */
+	public BungeeHandler(VotingPluginMain plugin) {
+		this.plugin = plugin;
+	}
+
+	/**
+	 * Checks and processes global data from the global data handler.
+	 */
+	public void checkGlobalData() {
+		HashMap<String, DataValue> data = globalDataHandler.getExact(plugin.getBungeeSettings().getServer());
+
+		if (data.containsKey("ForceUpdate")) {
+			boolean b = checkGlobalDataTimeValue(data.get("ForceUpdate"));
+			if (b) {
+				if (plugin.getStorageType().equals(UserStorage.MYSQL)) {
+					plugin.getMysql().clearCacheBasic();
+				}
+				plugin.getUserManager().getDataManager().clearCache();
+				plugin.setUpdate(true);
+				plugin.update();
+				globalDataHandler.setBoolean(plugin.getBungeeSettings().getServer(), "ForceUpdate", false);
+			}
+		}
+
+		boolean forceUpdate = false;
+
+		if (checkGlobalDataTime(TimeType.MONTH, data)) {
+			forceUpdate = true;
+		}
+		if (checkGlobalDataTime(TimeType.WEEK, data)) {
+			forceUpdate = true;
+		}
+		if (checkGlobalDataTime(TimeType.DAY, data)) {
+			forceUpdate = true;
+		}
+
+		if (forceUpdate) {
+			HashMap<String, DataValue> dataToSet = new HashMap<>();
+			dataToSet.put("FinishedProcessing", new DataValueBoolean(true));
+			dataToSet.put("Processing", new DataValueBoolean(false));
+			globalDataHandler.setData(plugin.getBungeeSettings().getServer(), dataToSet);
+		}
+	}
+
+	/**
+	 * Checks global data for a time type change.
+	 *
+	 * @param type the time type to check
+	 * @param data the global data map
+	 * @return true if currently processing a time change
+	 */
+	public boolean checkGlobalDataTime(TimeType type, HashMap<String, DataValue> data) {
+		boolean isProcessing = false;
+		if (data.containsKey(type.toString())) {
+
+			DataValue value = data.get(type.toString());
+			boolean b = checkGlobalDataTimeValue(value);
+			if (b) {
+				long lastUpdated = Long.valueOf(data.get("LastUpdated").getString()).longValue();
+				plugin.debug("LastUpdated: " + lastUpdated);
+				if (LocalDateTime.now().atZone(ZoneOffset.UTC).toInstant().toEpochMilli() - lastUpdated > 1000 * 60 * 60
+						* 2) {
+					plugin.getLogger().warning("Ignoring bungee time change since it was more than 2 hours ago");
+					globalDataHandler.setBoolean(plugin.getBungeeSettings().getServer(), type.toString(), false);
+					return false;
+				}
+
+				globalDataHandler.setBoolean(plugin.getBungeeSettings().getServer(), "Processing", true);
+				isProcessing = true;
+
+				plugin.debug("Detected time change from bungee: " + type.toString());
+				plugin.getTimeChecker().forceChanged(type, false, true, true);
+				globalDataHandler.setBoolean(plugin.getBungeeSettings().getServer(), type.toString(), false);
+
+				HashMap<String, Object> fields = new HashMap<>();
+				fields.put("server", plugin.getBungeeSettings().getServer());
+				sendSubChannel("TimeChangeFinished", fields);
+			}
+		}
+		return isProcessing;
+	}
+
+	/**
+	 * Checks and extracts the boolean value from a DataValue.
+	 *
+	 * @param data the data value
+	 * @return the boolean value
+	 */
+	public boolean checkGlobalDataTimeValue(DataValue data) {
+		if (data.isBoolean()) {
+			return data.getBoolean();
+		}
+		return Boolean.valueOf(data.getString());
+	}
+
+	/**
+	 * Closes and cleans up all handlers and connections.
+	 */
+	public void close() {
+		if (backendMysqlMessenger != null) {
+			backendMysqlMessenger.shutdown();
+		}
+
+		if (socketHandler != null) {
+			socketHandler.closeConnection();
+		}
+		if (clientHandler != null) {
+			clientHandler.stopConnection();
+		}
+		plugin.getServerData().setBungeeVotePartyCurrent(bungeeVotePartyCurrent);
+		plugin.getServerData().setBungeeVotePartyRequired(bungeeVotePartyRequired);
+		if (globalDataHandler != null) {
+			globalDataHandler.getGlobalMysql().close();
+		}
+	}
+
+	/**
+	 * Loads and initializes the bungee handler with the configured method.
+	 */
+	public void load() {
+		plugin.debug("Loading bungee handler");
+
+		method = BungeeMethod.getByName(plugin.getBungeeSettings().getBungeeMethod());
+
+		plugin.getLogger().info("Using BungeeMethod: " + method.toString());
+
+		loadGlobalMysql();
+
+		globalMessageHandler = new GlobalMessageHandler() {
+			@Override
+			public void sendMessage(JsonEnvelope envelope) {
+				if (method.equals(BungeeMethod.MYSQL)) {
+					try {
+						backendMysqlMessenger.sendToProxy(envelope);
+					} catch (SQLException e) {
+						e.printStackTrace();
+					}
+				} else if (method.equals(BungeeMethod.PLUGINMESSAGING)) {
+					plugin.getPluginMessaging().sendEnvelope(envelope);
+				} else if (method.equals(BungeeMethod.SOCKETS)) {
+					sendEnvelopeSocket(envelope);
+				} else if (method.equals(BungeeMethod.REDIS)) {
+					redisHandler.publishEnvelope(plugin.getBungeeSettings().getRedisPrefix() + "VotingPlugin",
+							envelope);
+				} else if (method.equals(BungeeMethod.MQTT)) {
+					try {
+						mqttHandler.publishEnvelope(
+								plugin.getBungeeSettings().getMqttPrefix() + "votingplugin/servers/proxy", envelope);
+					} catch (Exception e) {
+						e.printStackTrace();
+					}
+				}
+			}
+		};
+
+		// ==========================
+		// Vote / VoteOnline (wire decode)
+		// ==========================
+
+		globalMessageHandler.addListener(new GlobalMessageListener(VotingPluginWire.SUB_VOTE) {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				handleWireVote(msg);
+			}
+		});
+
+		globalMessageHandler.addListener(new GlobalMessageListener(VotingPluginWire.SUB_VOTE_ONLINE) {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				handleWireVote(msg);
+			}
+		});
+
+		globalMessageHandler.addListener(new GlobalMessageListener(VotingPluginWire.SUB_VOTE_UPDATE) {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				// Wire decode
+				VotingPluginWire.VoteUpdate v = VotingPluginWire.readVoteUpdate(msg);
+
+				String playerUuid = v.uuid;
+				if (playerUuid == null || playerUuid.isEmpty()) {
+					return;
+				}
+
+				plugin.debug("pluginmessaging voteupdate received for " + playerUuid + ": " + v.votePartyCurrent + "/"
+						+ v.votePartyRequired + " on " + v.service);
+
+				// Vote party cache update
+				if (v.votePartyCurrent >= 0 || bungeeVotePartyCurrent == -2) {
+					bungeeVotePartyCurrent = v.votePartyCurrent;
+				}
+				if (v.votePartyRequired >= 0 || bungeeVotePartyRequired == -2) {
+					bungeeVotePartyRequired = v.votePartyRequired;
+				}
+				plugin.getServerData().setBungeeVotePartyCurrent(bungeeVotePartyCurrent);
+				plugin.getServerData().setBungeeVotePartyRequired(bungeeVotePartyRequired);
+
+				VotingPluginUser user = plugin.getVotingPluginUserManager()
+						.getVotingPluginUser(UUID.fromString(playerUuid));
+				user.cache();
+
+				user.offVote();
+
+				// Optional: update last vote time for a service
+				String service = v.service;
+				long time = v.time;
+
+				if (service != null && !service.isEmpty() && time > 0) {
+					user.setTime(plugin.getVoteSiteManager().getVoteSite(service, true), time);
+				} else if (service != null && !service.isEmpty() && time <= 0
+						&& plugin.getBungeeSettings().isBungeeDebug()) {
+					plugin.debug("Invalid last vote time received from bungee: " + time);
+				}
+
+				plugin.setUpdate(true);
+			}
+		});
+
+		globalMessageHandler.addListener(new GlobalMessageListener(VotingPluginWire.SUB_BUNGEE_TIME_CHANGE) {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				checkGlobalData();
+			}
+		});
+
+		globalMessageHandler.addListener(new GlobalMessageListener(VotingPluginWire.SUB_VOTE_BROADCAST) {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				Map<String, String> f = msg.getFields();
+
+				final String uuidStr = nvl(f.get(VotingPluginWire.K_UUID));
+				final String playerNameRaw = nvl(f.get(VotingPluginWire.K_PLAYER));
+				final String service = nvl(f.get(VotingPluginWire.K_SERVICE));
+
+				if (uuidStr.isEmpty() || service.isEmpty()) {
+					return;
+				}
+
+				UUID javaUuid;
+				try {
+					javaUuid = UUID.fromString(uuidStr);
+				} catch (Exception e) {
+					plugin.getLogger().warning("Invalid UUID in VoteBroadcast: " + uuidStr);
+					return;
+				}
+
+				// New fields (May use later)
+				@SuppressWarnings("unused")
+				final long time = readLongSafe(f.get(VotingPluginWire.K_TIME), 0L);
+				@SuppressWarnings("unused")
+				final String totals = nvl(f.get(VotingPluginWire.K_TOTALS));
+
+				VoteSite voteSite = plugin.getVoteSiteManager()
+						.getVoteSite(plugin.getVoteSiteManager().getVoteSiteName(true, service), true);
+
+				if (voteSite == null) {
+					plugin.getLogger().warning("No voting site with the service site: '" + service + "'");
+					return;
+				}
+				if (!voteSite.isEnabled()) {
+					plugin.debug("Votesite: " + voteSite.getKey() + " is not enabled (VoteBroadcast)");
+					return;
+				}
+
+				// Same user retrieval strategy: UUID + (possibly empty) name
+				VotingPluginUser user = plugin.getVotingPluginUserManager().getVotingPluginUser(javaUuid,
+						playerNameRaw);
+
+				// Keep cache/name current like normal vote path does
+				user.cache();
+				user.updateName(true);
+
+				// Same broadcast logic as PlayerVoteListener
+				if (plugin.getBroadcastHandler() == null) {
+					return;
+				}
+
+				if (user.isVanished()) {
+					plugin.debug("Not broadcasting vote for vanished user: " + user.getPlayerName());
+					return;
+				}
+
+				final boolean online = user.isOnline(); // same behavior as non-bungee vote path
+				plugin.getBroadcastHandler().broadcastVote(user.getJavaUUID(), user.getPlayerName(),
+						voteSite.getDisplayName(), online);
+			}
+		});
+
+		globalMessageHandler.addListener(new GlobalMessageListener("Status") {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				String server = nvl(msg.getFields().get("server"));
+				HashMap<String, Object> out = new HashMap<>();
+				out.put("server", server);
+				sendSubChannel("statusokay", out);
+			}
+		});
+
+		globalMessageHandler.addListener(new GlobalMessageListener("ServerName") {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				String server = nvl(msg.getFields().get("server"));
+				if (!plugin.getOptions().getServer().equals(server)) {
+					plugin.getLogger().warning("Server name doesn't match in BungeeSettings.yml, should be " + server);
+				}
+			}
+		});
+
+		globalMessageHandler.addListener(new GlobalMessageListener("VotePartyBungee") {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				for (final String cmd : plugin.getBungeeSettings().getBungeeVotePartyGlobalCommands()) {
+					plugin.getBukkitScheduler().runTask(plugin, new Runnable() {
+						@Override
+						public void run() {
+							Bukkit.getServer().dispatchCommand(Bukkit.getConsoleSender(), cmd);
+						}
+					});
+				}
+				for (Player p : Bukkit.getOnlinePlayers()) {
+					new RewardBuilder(plugin.getBungeeSettings().getData(), "BungeeVotePartyRewards").send(p);
+				}
+			}
+		});
+
+		globalMessageHandler.addListener(new GlobalMessageListener("VotePartyBroadcast") {
+			@Override
+			public void onReceive(JsonEnvelope msg) {
+				String broadcast = nvl(msg.getFields().get("broadcast"));
+				MiscUtils.getInstance().broadcast(broadcast);
+			}
+		});
+
+		if (method.equals(BungeeMethod.MYSQL)) {
+			plugin.registerBungeeChannels(plugin.getBungeeSettings().getPluginMessagingChannel());
+
+			try {
+				backendMysqlMessenger = new MySqlMessenger("VotingPlugin",
+						plugin.getMysql().getMysql().getConnectionManager().getDataSource(),
+						MySqlMessenger.Mode.BACKEND, plugin.getOptions().getServer(), msg -> {
+							if (plugin.getBungeeSettings().isBungeeDebug()) {
+								plugin.debug("Proxy sent envelope: " + msg.envelope.getSubChannel() + " "
+										+ msg.envelope.getFields());
+							}
+							globalMessageHandler.onMessage(msg.envelope);
+						});
+			} catch (SQLException e) {
+				e.printStackTrace();
+			}
+		} else if (method.equals(BungeeMethod.REDIS)) {
+			redisHandler = new RedisHandler(plugin.getBungeeSettings().getRedisHost(),
+					plugin.getBungeeSettings().getRedisPort(), plugin.getBungeeSettings().getRedisUsername(),
+					plugin.getBungeeSettings().getRedisPassword(), plugin.getBungeeSettings().getRedisdbindex()) {
+
+				@Override
+				public void debug(String message) {
+					if (plugin.getBungeeSettings().isBungeeDebug()) {
+						plugin.debug(message);
+					}
+				}
+			};
+
+			redisThread = new Thread(new Runnable() {
+				@Override
+				public void run() {
+					if (plugin.isEnabled()) {
+						RedisListener listener = redisHandler.createEnvelopeListener(
+								plugin.getBungeeSettings().getRedisPrefix() + "VotingPlugin_"
+										+ plugin.getBungeeSettings().getServer(),
+								(ch, env) -> globalMessageHandler.onMessage(env));
+						redisHandler.loadListener(listener);
+					}
+				}
+			});
+			redisThread.start();
+
+		} else if (method.equals(BungeeMethod.PLUGINMESSAGING)) {
+			plugin.registerBungeeChannels(plugin.getBungeeSettings().getPluginMessagingChannel());
+
+			if (plugin.getBungeeSettings().isPluginMessageEncryption()) {
+				encryptionHandler = new EncryptionHandler(plugin.getName(),
+						new File(plugin.getDataFolder(), "secretkey.key"));
+				plugin.getPluginMessaging().setEncryptionHandler(encryptionHandler);
+			}
+
+			plugin.getPluginMessaging().setDebug(plugin.getBungeeSettings().isBungeeDebug());
+
+			plugin.getPluginMessaging().add(new PluginMessageHandler() {
+				@Override
+				public void onReceive(JsonEnvelope envelope) {
+					globalMessageHandler.onMessage(envelope);
+				}
+			});
+
+		} else if (method.equals(BungeeMethod.SOCKETS)) {
+			encryptionHandler = new EncryptionHandler(plugin.getName(),
+					new File(plugin.getDataFolder(), "secretkey.key"));
+
+			clientHandler = new ClientHandler(plugin.getBungeeSettings().getBungeeServerHost(),
+					plugin.getBungeeSettings().getBungeeServerPort(), encryptionHandler,
+					plugin.getBungeeSettings().isBungeeDebug());
+
+			socketHandler = new SocketHandler("vp-socket", plugin.getBungeeSettings().getSpigotServerHost(),
+					plugin.getBungeeSettings().getSpigotServerPort(), encryptionHandler,
+					plugin.getBungeeSettings().isBungeeDebug()) {
+
+				@Override
+				public void log(String str) {
+					plugin.getLogger().info(str);
+				}
+			};
+
+			socketHandler.add(new SocketReceiver() {
+				@Override
+				public void onReceiveEnvelope(JsonEnvelope envelope) {
+					globalMessageHandler.onMessage(envelope);
+				}
+			});
+
+		} else if (method.equals(BungeeMethod.MQTT)) {
+			try {
+				String id = plugin.getBungeeSettings().getMqttClientID();
+				if (id.isEmpty()) {
+					id = plugin.getOptions().getServer();
+				}
+				mqttHandler = new MqttHandler(new MqttServerComm(id, plugin.getBungeeSettings().getMqttBrokerURL(),
+						plugin.getBungeeSettings().getMqttUsername(), plugin.getBungeeSettings().getMqttPassword()), 2);
+
+				mqttHandler.subscribeEnvelopes(
+						plugin.getBungeeSettings().getMqttPrefix() + "votingplugin/servers/"
+								+ plugin.getOptions().getServer(),
+						(topic, envelope) -> globalMessageHandler.onMessage(envelope));
+
+			} catch (MqttException e) {
+				e.printStackTrace();
+			} catch (Exception e) {
+				e.printStackTrace();
+			}
+		}
+
+		bungeeVotePartyCurrent = plugin.getServerData().getBungeeVotePartyCurrent();
+		bungeeVotePartyRequired = plugin.getServerData().getBungeeVotePartyRequired();
+
+		if (plugin.getOptions().getServer().equalsIgnoreCase("pleaseset")) {
+			plugin.getLogger().warning("Server name for bungee voting is not set, please set it");
+		}
+	}
+
+	private static long readLongSafe(String v, long def) {
+		if (v == null)
+			return def;
+		try {
+			return Long.parseLong(v);
+		} catch (Exception ignored) {
+			return def;
+		}
+	}
+
+	/**
+	 * Wire vote handler (Vote + VoteOnline).
+	 */
+	private void handleWireVote(JsonEnvelope msg) {
+		// Strict schema check (wire uses envelope schema, not a "bungeeVersion" field)
+		int schema = msg.getSchema();
+		if (schema != VotingPluginWire.SCHEMA_VERSION) {
+			plugin.getLogger().warning("Incompatible version with bungee/proxy, please update all servers: " + schema
+					+ " != " + VotingPluginWire.SCHEMA_VERSION);
+			return;
+		}
+
+		VotingPluginWire.Vote v = VotingPluginWire.readVote(msg);
+
+		String uuidStr = v.uuid;
+		String player = v.player;
+		String service = v.service;
+
+		if (uuidStr == null || uuidStr.isEmpty()) {
+			return;
+		}
+
+		plugin.debug("wire vote received from " + player + "/" + uuidStr + " on " + service);
+
+		VoteTotalsSnapshot text = VoteTotalsSnapshot.parseStorage(v.totals == null ? "" : v.totals);
+		@SuppressWarnings("deprecation")
+		UUID voteId = v.voteId != null ? v.voteId : text.getVoteUUID();
+
+		if (!reserveWireVote(voteId)) {
+			plugin.debug("Ignoring duplicate wire vote " + voteId + " for " + player + " on " + service);
+			return;
+		}
+
+		VotingPluginUser user = plugin.getVotingPluginUserManager().getVotingPluginUser(UUID.fromString(uuidStr),
+				player);
+
+		bungeeVotePartyCurrent = text.getVotePartyCurrent();
+		bungeeVotePartyRequired = text.getVotePartyRequired();
+		plugin.getServerData().setBungeeVotePartyCurrent(bungeeVotePartyCurrent);
+		plugin.getServerData().setBungeeVotePartyRequired(bungeeVotePartyRequired);
+
+		user.cache();
+
+		boolean setTotalsOnBackend = !v.manageTotals;
+
+		user.bungeeVotePluginMessaging(service, v.time, text, setTotalsOnBackend, v.wasOnline, v.broadcast, v.num);
+
+		if (plugin.getBungeeSettings().isPerServerPoints()) {
+			user.addPoints(plugin.getConfigFile().getPointsOnVote());
+		}
+
+		if (service != null && !service.isEmpty()) {
+			plugin.getServerData().addServiceSite(service);
+		}
+
+		@SuppressWarnings("unused")
+		int _ignored = v.numberOfVotes;
+	}
+
+	/**
+	 * Reserves a wire vote for processing.
+	 *
+	 * @param voteId unique vote identifier
+	 * @return true if the vote has not been processed recently
+	 */
+	private boolean reserveWireVote(UUID voteId) {
+		if (voteId == null) {
+			return true;
+		}
+
+		long now = System.currentTimeMillis();
+		long expiresAt = now + PROCESSED_VOTE_TTL_MILLIS;
+
+		while (true) {
+			Long currentExpiry = processedWireVotes.get(voteId);
+			if (currentExpiry == null) {
+				if (processedWireVotes.putIfAbsent(voteId, expiresAt) == null) {
+					cleanupProcessedWireVotes(now);
+					return true;
+				}
+				continue;
+			}
+
+			if (currentExpiry > now) {
+				return false;
+			}
+
+			if (processedWireVotes.replace(voteId, currentExpiry, expiresAt)) {
+				cleanupProcessedWireVotes(now);
+				return true;
+			}
+		}
+	}
+
+	/**
+	 * Removes expired wire vote identifiers.
+	 *
+	 * @param now current timestamp
+	 */
+	private void cleanupProcessedWireVotes(long now) {
+		processedWireVotes.entrySet().removeIf(entry -> entry.getValue() <= now);
+	}
+
+	/**
+	 * Loads the global MySQL handler for cross-server data synchronization.
+	 */
+	public void loadGlobalMysql() {
+		if (plugin.getBungeeSettings().isGloblalDataEnabled()) {
+			if (timer != null) {
+				timer.shutdown();
+				try {
+					timer.awaitTermination(5, TimeUnit.SECONDS);
+				} catch (InterruptedException e) {
+					e.printStackTrace();
+				}
+				timer.shutdownNow();
+			}
+			timer = Executors.newScheduledThreadPool(1);
+			timer.scheduleWithFixedDelay(new Runnable() {
+				@Override
+				public void run() {
+					checkGlobalData();
+				}
+			}, 60, 10, TimeUnit.SECONDS);
+			timer.scheduleWithFixedDelay(new Runnable() {
+				@Override
+				public void run() {
+					globalDataHandler.setString(plugin.getBungeeSettings().getServer(), "LastOnline",
+							"" + LocalDateTime.now().atZone(ZoneOffset.UTC).toInstant().toEpochMilli());
+				}
+			}, 1, 60, TimeUnit.MINUTES);
+
+			if (globalDataHandler != null) {
+				globalDataHandler.getGlobalMysql().close();
+			}
+
+			if (plugin.getBungeeSettings().isGloblalDataUseMainMySQL()
+					&& plugin.getStorageType().equals(UserStorage.MYSQL)) {
+				globalDataHandler = new GlobalDataHandler(
+						new GlobalMySQL("VotingPlugin_GlobalData", plugin.getMysql().getMysql()) {
+							@Override
+							public void debugEx(Exception e) {
+								plugin.debug(e);
+							}
+
+							@Override
+							public void debugLog(String text) {
+								plugin.debug(text);
+							}
+
+							@Override
+							public void info(String text) {
+								plugin.getLogger().info(text);
+							}
+
+							@Override
+							public void logSevere(String text) {
+								plugin.getLogger().severe(text);
+							}
+
+							@Override
+							public void warning(String text) {
+								plugin.getLogger().warning(text);
+							}
+						});
+			} else {
+				globalDataHandler = new GlobalDataHandler(
+						new GlobalMySQL("VotingPlugin_GlobalData", new MysqlConfigSpigot(
+								plugin.getBungeeSettings().getData().getConfigurationSection("GlobalData"))) {
+							@Override
+							public void debugEx(Exception e) {
+								plugin.debug(e);
+							}
+
+							@Override
+							public void debugLog(String text) {
+								plugin.debug(text);
+							}
+
+							@Override
+							public void info(String text) {
+								plugin.getLogger().info(text);
+							}
+
+							@Override
+							public void logSevere(String text) {
+								plugin.getLogger().severe(text);
+							}
+
+							@Override
+							public void warning(String text) {
+								plugin.getLogger().warning(text);
+							}
+						});
+			}
+
+			globalDataHandler.getGlobalMysql().alterColumnType("IgnoreTime", "VARCHAR(5)");
+			globalDataHandler.getGlobalMysql().alterColumnType("MONTH", "VARCHAR(5)");
+			globalDataHandler.getGlobalMysql().alterColumnType("WEEK", "VARCHAR(5)");
+			globalDataHandler.getGlobalMysql().alterColumnType("DAY", "VARCHAR(5)");
+			globalDataHandler.getGlobalMysql().alterColumnType("FinishedProcessing", "VARCHAR(5)");
+			globalDataHandler.getGlobalMysql().alterColumnType("Processing", "VARCHAR(5)");
+			globalDataHandler.getGlobalMysql().alterColumnType("LastUpdated", "MEDIUMTEXT");
+			globalDataHandler.getGlobalMysql().alterColumnType("ForceUpdate", "VARCHAR(5)");
+			plugin.getTimeChecker().setProcessingEnabled(false);
+		}
+	}
+
+	private void sendEnvelopeSocket(JsonEnvelope envelope) {
+		if (clientHandler != null) {
+			clientHandler.sendEnvelope(envelope);
+		}
+	}
+
+	private void sendSubChannel(String subChannel, HashMap<String, Object> fields) {
+		JsonEnvelope.Builder b = JsonEnvelope.builder(subChannel).schema(VotingPluginWire.SCHEMA_VERSION);
+		if (fields != null) {
+			for (Map.Entry<String, Object> e : fields.entrySet()) {
+				b.put(e.getKey(), e.getValue());
+			}
+		}
+		globalMessageHandler.sendMessage(b.build());
+	}
+
+	private static String nvl(String s) {
+		return s == null ? "" : s;
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/VotingPluginMetrics.java

@@ -2,24 +2,36 @@ package com.bencodez.votingplugin;
 
 import java.util.concurrent.Callable;
 
+import org.bukkit.configuration.ConfigurationSection;
+
 import com.bencodez.simpleapi.metrics.BStatsMetrics;
 
+/**
+ * Registers bStats charts for VotingPlugin.
+ * <p>
+ * Updated for VotingPlugin 7.0:
+ * <ul>
+ * <li>Broadcast: Always logs broadcast_type if VoteBroadcast.Type exists. If Type == NONE, ignores other broadcast
+ * settings.</li>
+ * <li>VoteLogging: Only logs VoteLogging charts when VoteLogging.Enabled is true.</li>
+ * <li>No "Unknown" values are emitted; charts are only registered when their data exists.</li>
+ * <li>VoteMilestones chart is bucketed to reduce cardinality.</li>
+ * </ul>
+ */
 public class VotingPluginMetrics {
 
-	public void load(VotingPluginMain plugin) {
-		BStatsMetrics metrics = new BStatsMetrics(plugin, 38);
+	/**
+	 * Register bStats metrics.
+	 *
+	 * @param plugin VotingPlugin main instance
+	 */
+	public void load(final VotingPluginMain plugin) {
+		if (plugin == null) {
+			return;
+		}
 
-		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_firstvote", new Callable<String>() {
+		final BStatsMetrics metrics = new BStatsMetrics(plugin, 38);
 
-			@Override
-			public String call() throws Exception {
-				if (plugin.getRewardHandler().hasRewards(plugin.getSpecialRewardsConfig().getData(),
-						plugin.getSpecialRewardsConfig().getFirstVoteRewardsPath())) {
-					return "True";
-				}
-				return "False";
-			}
-		}));
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_everysite", new Callable<String>() {
 
 			@Override
@@ -31,32 +43,7 @@ public class VotingPluginMetrics {
 				return "False";
 			}
 		}));
-		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_allsites", new Callable<String>() {
 
-			@Override
-			public String call() throws Exception {
-				if (plugin.getRewardHandler().hasRewards(plugin.getSpecialRewardsConfig().getData(),
-						plugin.getSpecialRewardsConfig().getAllSitesRewardPath())) {
-					return "True";
-				}
-				return "False";
-			}
-		}));
-		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_cumulative", new Callable<String>() {
-
-			@Override
-			public String call() throws Exception {
-				if (plugin.getSpecialRewardsConfig().getCumulativeVotes().size() == 0) {
-					return "False";
-				}
-				for (String cum : plugin.getSpecialRewardsConfig().getCumulativeVotes()) {
-					if (plugin.getSpecialRewardsConfig().getCumulativeRewardEnabled(Integer.parseInt(cum))) {
-						return "True";
-					}
-				}
-				return "False";
-			}
-		}));
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_voteparty", new Callable<String>() {
 
 			@Override
@@ -67,6 +54,7 @@ public class VotingPluginMetrics {
 				return "True";
 			}
 		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("placeholder_cache_level", new Callable<String>() {
 
 			@Override
@@ -74,21 +62,16 @@ public class VotingPluginMetrics {
 				return plugin.getPlaceholders().getCacheLevel().toString();
 			}
 		}));
-		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_milestone", new Callable<String>() {
+
+		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_votemilestones", new Callable<String>() {
 
 			@Override
 			public String call() throws Exception {
-				if (plugin.getSpecialRewardsConfig().getMilestoneVotes().size() == 0) {
-					return "False";
-				}
-				for (String milestone : plugin.getSpecialRewardsConfig().getMilestoneVotes()) {
-					if (plugin.getSpecialRewardsConfig().getMilestoneRewardEnabled(Integer.parseInt(milestone))) {
-						return "True";
-					}
-				}
-				return "False";
+				int size = plugin.getVoteMilestonesManager().getConfig().getMilestones().size();
+				return bucketCount(size);
 			}
 		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_anysitereward", new Callable<String>() {
 
 			@Override
@@ -100,63 +83,15 @@ public class VotingPluginMetrics {
 				return "False";
 			}
 		}));
-		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_votestreakday", new Callable<String>() {
 
-			@Override
-			public String call() throws Exception {
-				for (String s : plugin.getSpecialRewardsConfig().getVoteStreakVotes("Day")) {
-
-					if (plugin.getSpecialRewardsConfig().getVoteStreakRewardEnabled("Day", s)
-							&& plugin.getRewardHandler().hasRewards(plugin.getSpecialRewardsConfig().getData(),
-									plugin.getSpecialRewardsConfig().getVoteStreakRewardsPath("Day", s))) {
-						return "True";
-					}
-
-				}
-				return "False";
-			}
-		}));
-
-		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_votestreakweek", new Callable<String>() {
-
-			@Override
-			public String call() throws Exception {
-				for (String s : plugin.getSpecialRewardsConfig().getVoteStreakVotes("Week")) {
-
-					if (plugin.getSpecialRewardsConfig().getVoteStreakRewardEnabled("Week", s)
-							&& plugin.getRewardHandler().hasRewards(plugin.getSpecialRewardsConfig().getData(),
-									plugin.getSpecialRewardsConfig().getVoteStreakRewardsPath("Week", s))) {
-						return "True";
-					}
-				}
-
-				return "False";
-			}
-		}));
-
-		metrics.addCustomChart(new BStatsMetrics.SimplePie("extrarewards_votestreakmonth", new Callable<String>() {
-
-			@Override
-			public String call() throws Exception {
-				for (String s : plugin.getSpecialRewardsConfig().getVoteStreakVotes("Month")) {
-
-					if (plugin.getSpecialRewardsConfig().getVoteStreakRewardEnabled("Month", s)
-							&& plugin.getRewardHandler().hasRewards(plugin.getSpecialRewardsConfig().getData(),
-									plugin.getSpecialRewardsConfig().getVoteStreakRewardsPath("Month", s))) {
-						return "True";
-					}
-				}
-
-				return "False";
-			}
-		}));
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("numberofsites", new Callable<String>() {
 
 			@Override
 			public String call() throws Exception {
-				return "" + plugin.getVoteSitesEnabled().size();
+				return "" + plugin.getVoteSiteManager().getVoteSitesEnabled().size();
 			}
 		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("numberofrewards", new Callable<String>() {
 
 			@Override
@@ -164,6 +99,7 @@ public class VotingPluginMetrics {
 				return "" + plugin.getRewardHandler().getRewards().size();
 			}
 		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("autocreatevotesites", new Callable<String>() {
 
 			@Override
@@ -172,6 +108,14 @@ public class VotingPluginMetrics {
 			}
 		}));
 
+		metrics.addCustomChart(new BStatsMetrics.SimplePie("config_onlinemode", new Callable<String>() {
+
+			@Override
+			public String call() throws Exception {
+				return "" + plugin.getOptions().isOnlineMode();
+			}
+		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("numberofusers", new Callable<String>() {
 
 			@Override
@@ -209,6 +153,7 @@ public class VotingPluginMetrics {
 				return plugin.getOptions().getStorageType().toString();
 			}
 		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("DisableCheckOnWorldChange", new Callable<String>() {
 
 			@Override
@@ -216,13 +161,7 @@ public class VotingPluginMetrics {
 				return "" + plugin.getOptions().isDisableCheckOnWorldChange();
 			}
 		}));
-		metrics.addCustomChart(new BStatsMetrics.SimplePie("votereminding_enabled", new Callable<String>() {
 
-			@Override
-			public String call() throws Exception {
-				return "" + plugin.getConfigFile().isVoteRemindingEnabled();
-			}
-		}));
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("LoadTopVoter_Monthly", new Callable<String>() {
 
 			@Override
@@ -230,6 +169,7 @@ public class VotingPluginMetrics {
 				return "" + plugin.getConfigFile().isLoadTopVoterMonthly();
 			}
 		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("LoadTopVoter_Weekly", new Callable<String>() {
 
 			@Override
@@ -237,6 +177,7 @@ public class VotingPluginMetrics {
 				return "" + plugin.getConfigFile().isLoadTopVoterWeekly();
 			}
 		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("LoadTopVoter_Daily", new Callable<String>() {
 
 			@Override
@@ -244,6 +185,7 @@ public class VotingPluginMetrics {
 				return "" + plugin.getConfigFile().isLoadTopVoterDaily();
 			}
 		}));
+
 		metrics.addCustomChart(new BStatsMetrics.SimplePie("bungeemethod", new Callable<String>() {
 
 			@Override
@@ -254,22 +196,8 @@ public class VotingPluginMetrics {
 				return "Disabled";
 			}
 		}));
+
 		if (plugin.getBungeeSettings().isUseBungeecoord()) {
-			metrics.addCustomChart(new BStatsMetrics.SimplePie("bungeebroadcast", new Callable<String>() {
-
-				@Override
-				public String call() throws Exception {
-					return "" + plugin.getBungeeSettings().isBungeeBroadcast();
-				}
-			}));
-			metrics.addCustomChart(new BStatsMetrics.SimplePie("bungeebroadcastalways", new Callable<String>() {
-
-				@Override
-				public String call() throws Exception {
-					return "" + plugin.getBungeeSettings().isBungeeBroadcastAlways();
-				}
-			}));
-
 			metrics.addCustomChart(new BStatsMetrics.SimplePie("perserverrewards", new Callable<String>() {
 
 				@Override
@@ -368,5 +296,188 @@ public class VotingPluginMetrics {
 				}
 			}));
 		}
+
+		/*
+		 * ---------------------------------------------------------------------
+		 * Broadcast metrics:
+		 * - Always log broadcast_type if VoteBroadcast.Type exists (even if NONE)
+		 * - If Type == NONE, ignore the rest of the broadcast settings
+		 * ---------------------------------------------------------------------
+		 */
+		final ConfigurationSection root = safeConfig(plugin);
+		final ConfigurationSection voteBroadcast = getSection(root, "VoteBroadcast");
+		if (voteBroadcast != null && voteBroadcast.isString("Type")) {
+
+			metrics.addCustomChart(new BStatsMetrics.SimplePie("broadcast_type", new Callable<String>() {
+				@Override
+				public String call() throws Exception {
+					return voteBroadcast.getString("Type");
+				}
+			}));
+
+			final String type = voteBroadcast.getString("Type", null);
+			if (type != null && !"NONE".equalsIgnoreCase(type)) {
+
+				if (voteBroadcast.isString("Duration")) {
+					metrics.addCustomChart(new BStatsMetrics.SimplePie("broadcast_duration", new Callable<String>() {
+						@Override
+						public String call() throws Exception {
+							return voteBroadcast.getString("Duration");
+						}
+					}));
+				}
+
+				if (voteBroadcast.isInt("MaxSitesListed")) {
+					metrics.addCustomChart(new BStatsMetrics.SimplePie("broadcast_max_sites_listed",
+							new Callable<String>() {
+								@Override
+								public String call() throws Exception {
+									return bucketMaxSites(voteBroadcast.getInt("MaxSitesListed"));
+								}
+							}));
+				}
+			}
+		}
+
+		/*
+		 * ---------------------------------------------------------------------
+		 * VoteLogging metrics:
+		 * - Only log when VoteLogging.Enabled is true
+		 * ---------------------------------------------------------------------
+		 */
+		final ConfigurationSection voteLogging = getSection(root, "VoteLogging");
+		if (voteLogging != null && voteLogging.getBoolean("Enabled", false)) {
+
+			if (voteLogging.isInt("PurgeDays")) {
+				metrics.addCustomChart(new BStatsMetrics.SimplePie("votelogging_purgedays", new Callable<String>() {
+					@Override
+					public String call() throws Exception {
+						return bucketPurgeDays(voteLogging.getInt("PurgeDays"));
+					}
+				}));
+			}
+
+			if (voteLogging.isBoolean("UseMainMySQL")) {
+				metrics.addCustomChart(new BStatsMetrics.SimplePie("votelogging_usemainmysql", new Callable<String>() {
+					@Override
+					public String call() throws Exception {
+						return "" + voteLogging.getBoolean("UseMainMySQL");
+					}
+				}));
+			}
+		}
+	}
+
+	/**
+	 * Safely gets the root configuration section.
+	 *
+	 * @param plugin plugin instance
+	 * @return root config section, or null if inaccessible
+	 */
+	private ConfigurationSection safeConfig(final VotingPluginMain plugin) {
+		try {
+			return plugin.getConfigFile().getData();
+		} catch (Exception ignored) {
+			return null;
+		}
+	}
+
+	/**
+	 * Gets a child section safely.
+	 *
+	 * @param root root section
+	 * @param key  child key
+	 * @return child section or null
+	 */
+	private ConfigurationSection getSection(final ConfigurationSection root, final String key) {
+		if (root == null) {
+			return null;
+		}
+		try {
+			return root.getConfigurationSection(key);
+		} catch (Exception ignored) {
+			return null;
+		}
+	}
+
+	/**
+	 * Buckets a milestone count to reduce bStats cardinality.
+	 *
+	 * @param count count
+	 * @return bucket string
+	 */
+	private String bucketCount(final int count) {
+		if (count <= 0) {
+			return "0";
+		}
+		if (count == 1) {
+			return "1";
+		}
+		if (count <= 5) {
+			return "2-5";
+		}
+		if (count <= 10) {
+			return "6-10";
+		}
+		if (count <= 25) {
+			return "11-25";
+		}
+		if (count <= 50) {
+			return "26-50";
+		}
+		if (count <= 100) {
+			return "51-100";
+		}
+		return ">100";
+	}
+
+	/**
+	 * Buckets MaxSitesListed to reduce bStats cardinality.
+	 *
+	 * @param maxSites max sites listed
+	 * @return bucket string
+	 */
+	private String bucketMaxSites(final int maxSites) {
+		if (maxSites <= 0) {
+			return "0";
+		}
+		if (maxSites <= 5) {
+			return "1-5";
+		}
+		if (maxSites <= 10) {
+			return "6-10";
+		}
+		if (maxSites <= 25) {
+			return "11-25";
+		}
+		return ">25";
+	}
+
+	/**
+	 * Buckets purge days to reduce bStats cardinality.
+	 *
+	 * @param purgeDays purge days
+	 * @return bucket string
+	 */
+	private String bucketPurgeDays(final int purgeDays) {
+		if (purgeDays < 0) {
+			return "disabled";
+		}
+		if (purgeDays == 0) {
+			return "0";
+		}
+		if (purgeDays <= 7) {
+			return "1-7";
+		}
+		if (purgeDays <= 30) {
+			return "8-30";
+		}
+		if (purgeDays <= 90) {
+			return "31-90";
+		}
+		if (purgeDays <= 365) {
+			return "91-365";
+		}
+		return ">365";
 	}
 }

VotingPlugin/src/main/java/com/bencodez/votingplugin/broadcast/BroadcastFormat.java

@@ -0,0 +1,126 @@
+package com.bencodez.votingplugin.broadcast;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.StringJoiner;
+
+/**
+ * Defines HOW vote broadcasts are rendered.
+ *
+ * Terminology:
+ * - BroadcastMsg : used when EXACTLY ONE item exists (single-site vote)
+ * - Header       : used ONCE when MULTIPLE items exist (batch/interval)
+ * - ListLine     : used ONCE PER ITEM when MULTIPLE items exist
+ *
+ * Placeholders (always available):
+ * - %player%        : player name (or "Server" for interval summaries)
+ * - %site%          : the current site/item for this line
+ * - %sites_count%   : number of items in the list
+ * - %sites%         : csv of items in the list
+ * - %reason%        : internal reason string ("vote", "batch", "interval", etc)
+ *
+ * Extra context placeholders (INTERVAL_SUMMARY_GLOBAL):
+ * - %players% / %numberofplayers%
+ * - %sites% / %numberofsites%   (note: %sites% is csv; %numberofsites% is count)
+ */
+public final class BroadcastFormat {
+
+	private final String broadcastMsg;
+	private final String header;
+	private final String listLine;
+
+	/**
+	 * Constructor for BroadcastFormat.
+	 *
+	 * @param broadcastMsg the broadcast message template
+	 * @param header the header template
+	 * @param listLine the list line template
+	 */
+	public BroadcastFormat(String broadcastMsg, String header, String listLine) {
+		this.broadcastMsg = broadcastMsg == null ? "" : broadcastMsg;
+		this.header = header == null ? "" : header;
+		this.listLine = listLine == null ? "" : listLine;
+	}
+
+	/**
+	 * Render the broadcast with player name, items, and reason.
+	 *
+	 * @param playerName the player name
+	 * @param items the list of items
+	 * @param reason the reason string
+	 * @return the rendered list of strings
+	 */
+	public List<String> render(String playerName, List<String> items, String reason) {
+		return render(playerName, items, reason, Collections.<String, String>emptyMap());
+	}
+
+	/**
+	 * Render the broadcast with player name, items, reason, and context.
+	 *
+	 * @param playerName the player name
+	 * @param items the list of items
+	 * @param reason the reason string
+	 * @param context additional context placeholders
+	 * @return the rendered list of strings
+	 */
+	public List<String> render(String playerName, List<String> items, String reason, Map<String, String> context) {
+		List<String> output = new ArrayList<String>();
+		int count = items == null ? 0 : items.size();
+
+		String csv = "";
+		if (count > 0) {
+			StringJoiner joiner = new StringJoiner(", ");
+			for (String s : items) {
+				if (s != null && !s.isEmpty()) {
+					joiner.add(s);
+				}
+			}
+			csv = joiner.toString();
+		}
+
+		// SINGLE ITEM → BroadcastMsg
+		if (count == 1 && !broadcastMsg.isEmpty()) {
+			output.add(apply(broadcastMsg, playerName, items.get(0), count, csv, reason, context));
+			return output;
+		}
+
+		// MULTI ITEM → Header + ListLine per item
+		if (!header.isEmpty()) {
+			output.add(apply(header, playerName, "", count, csv, reason, context));
+		}
+
+		if (count > 0 && !listLine.isEmpty()) {
+			for (String s : items) {
+				output.add(apply(listLine, playerName, s, count, csv, reason, context));
+			}
+		}
+
+		return output;
+	}
+
+	private String apply(String template,
+			String player,
+			String item,
+			int count,
+			String csv,
+			String reason,
+			Map<String, String> context) {
+
+		String out = template
+				.replace("%player%", player == null ? "" : player)
+				.replace("%site%", item == null ? "" : item)
+				.replace("%sites_count%", String.valueOf(count))
+				.replace("%sites%", csv == null ? "" : csv)
+				.replace("%reason%", reason == null ? "" : reason);
+
+		if (context != null && !context.isEmpty()) {
+			for (Map.Entry<String, String> e : context.entrySet()) {
+				out = out.replace("%" + e.getKey() + "%", e.getValue());
+			}
+		}
+
+		return out;
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/broadcast/BroadcastHandler.java

@@ -0,0 +1,513 @@
+package com.bencodez.votingplugin.broadcast;
+
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.ZoneId;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+import java.util.StringJoiner;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.regex.Pattern;
+
+import org.bukkit.Bukkit;
+import org.bukkit.OfflinePlayer;
+import org.bukkit.entity.Player;
+import org.bukkit.scheduler.BukkitTask;
+
+import com.bencodez.advancedcore.api.messages.PlaceholderUtils;
+import com.bencodez.simpleapi.messages.MessageAPI;
+import com.bencodez.simpleapi.player.PlayerUtils;
+import com.bencodez.simpleapi.time.ParsedDuration;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+
+/**
+ * Core broadcast logic.
+ *
+ * Decides when to broadcast and builds lines and messages. Uses the existing
+ * eligible online players behavior and respects disabled broadcasts.
+ *
+ * Backend servers only.
+ */
+public final class BroadcastHandler {
+
+	private final VotingPluginMain plugin;
+
+	/**
+	 * Only used for day-boundary logic for first vote of day broadcasts.
+	 */
+	private final ZoneId zoneId;
+
+	private volatile BroadcastSettings settings;
+
+	private final ConcurrentHashMap<UUID, Instant> lastBroadcastAt = new ConcurrentHashMap<UUID, Instant>();
+
+	private final ConcurrentHashMap<UUID, LinkedHashSet<String>> pendingSites = new ConcurrentHashMap<UUID, LinkedHashSet<String>>();
+	private final ConcurrentHashMap<UUID, BukkitTask> pendingFlush = new ConcurrentHashMap<UUID, BukkitTask>();
+
+	private final ConcurrentHashMap<UUID, LocalDate> firstVoteDay = new ConcurrentHashMap<UUID, LocalDate>();
+
+	private final ConcurrentHashMap<UUID, LinkedHashSet<String>> intervalSites = new ConcurrentHashMap<UUID, LinkedHashSet<String>>();
+	private volatile BukkitTask intervalTask;
+
+	/**
+	 * Constructs a new broadcast handler.
+	 *
+	 * @param plugin the main plugin instance
+	 * @param settings the broadcast settings
+	 * @param zoneId the time zone ID, or null to use the system default
+	 */
+	public BroadcastHandler(VotingPluginMain plugin, BroadcastSettings settings, ZoneId zoneId) {
+		this.plugin = plugin;
+		this.settings = settings;
+		this.zoneId = zoneId == null ? ZoneId.systemDefault() : zoneId;
+
+		rescheduleIntervalIfNeeded();
+	}
+
+	/**
+	 * Updates the broadcast settings and reschedules the interval task when
+	 * required.
+	 *
+	 * @param settings the new broadcast settings
+	 */
+	public void setSettings(BroadcastSettings settings) {
+		this.settings = settings;
+		rescheduleIntervalIfNeeded();
+	}
+
+	/**
+	 * Handles a received vote.
+	 *
+	 * @param uuid the voted player's UUID
+	 * @param playerName the player name, or null to resolve it from Bukkit
+	 * @param siteName the vote site display name
+	 * @param wasOnline whether the voted player was online when the vote was received
+	 */
+	public void broadcastVote(UUID uuid, String playerName, String siteName, boolean wasOnline) {
+		BroadcastSettings currentSettings = settings;
+		if (currentSettings == null || currentSettings.isDisabled()) {
+			return;
+		}
+
+		recordInterval(uuid, siteName);
+
+		String name = playerName == null || playerName.isEmpty() ? resolveName(uuid) : playerName;
+		VoteBroadcastType type = currentSettings.getType();
+
+		if (type == VoteBroadcastType.EVERY_VOTE_ONLINE_ONLY) {
+			if (!wasOnline) {
+				return;
+			}
+			broadcastNow(uuid, name, single(siteName), "vote_online_only", null);
+			return;
+		}
+
+		if (type == VoteBroadcastType.EVERY_VOTE) {
+			broadcastNow(uuid, name, single(siteName), "vote", null);
+		} else if (type == VoteBroadcastType.COOLDOWN_PER_PLAYER) {
+			if (checkAndMarkCooldown(uuid, currentSettings.getDuration())) {
+				broadcastNow(uuid, name, single(siteName), "cooldown", null);
+			}
+		} else if (type == VoteBroadcastType.BATCH_WINDOW_PER_PLAYER) {
+			bufferBatch(uuid, name, siteName, currentSettings.getDuration());
+		} else if (type == VoteBroadcastType.FIRST_VOTE_OF_DAY) {
+			if (markFirstVoteOfDay(uuid)) {
+				broadcastNow(uuid, name, single(siteName), "first_day", null);
+			}
+		} else if (type == VoteBroadcastType.INTERVAL_SUMMARY_GLOBAL) {
+			// Handled by the scheduled interval task.
+		}
+	}
+
+	/**
+	 * Renders and broadcasts a message.
+	 *
+	 * All PlaceholderAPI placeholders are evaluated using the voted player before
+	 * the message is sent to recipients.
+	 *
+	 * @param votedPlayerUuid the voted player's UUID, or null when no single player applies
+	 * @param playerName the rendered player name
+	 * @param sites the vote sites
+	 * @param reason the broadcast reason
+	 * @param extraContext additional format context, or null
+	 */
+	private void broadcastNow(UUID votedPlayerUuid, String playerName, List<String> sites, String reason,
+			Map<String, String> extraContext) {
+		BroadcastSettings currentSettings = settings;
+		if (currentSettings == null || currentSettings.isDisabled()) {
+			return;
+		}
+
+		List<String> cleaned = applyMaxSites(sites, currentSettings);
+		cleaned.sort(new Comparator<String>() {
+			@Override
+			public int compare(String first, String second) {
+				String firstValue = first == null ? "" : first.toLowerCase(Locale.ROOT);
+				String secondValue = second == null ? "" : second.toLowerCase(Locale.ROOT);
+				return firstValue.compareTo(secondValue);
+			}
+		});
+
+		List<String> lines;
+		if (extraContext == null) {
+			lines = currentSettings.getFormat().render(playerName, cleaned, reason);
+		} else {
+			lines = currentSettings.getFormat().render(playerName, cleaned, reason, extraContext);
+		}
+
+		OfflinePlayer votedPlayer = votedPlayerUuid == null ? null : Bukkit.getOfflinePlayer(votedPlayerUuid);
+
+		for (String line : lines) {
+			String parsedLine = PlaceholderUtils.replacePlaceHolders(votedPlayer, line);
+			broadcastToEligiblePlayers(parsedLine);
+		}
+	}
+
+	/**
+	 * Broadcasts a message that has already had PlaceholderAPI placeholders parsed.
+	 *
+	 * Placeholder parsing is intentionally not performed for each recipient because
+	 * all placeholders must be based on the voted player. JSON-style click and hover
+	 * formatting is still parsed for each recipient.
+	 *
+	 * @param broadcastMessage the parsed message
+	 */
+	private void broadcastToEligiblePlayers(String broadcastMessage) {
+		if (broadcastMessage == null || broadcastMessage.isEmpty()) {
+			return;
+		}
+
+		for (Player player : Bukkit.getOnlinePlayers()) {
+			VotingPluginUser user = plugin.getVotingPluginUserManager().getVotingPluginUser(player);
+			if (user == null || user.getDisableBroadcast()) {
+				continue;
+			}
+
+			for (String firstSplit : broadcastMessage.split(Pattern.quote("%newline%"))) {
+				for (String message : firstSplit.split(Pattern.quote("%NewLine%"))) {
+					String colorizedMessage = MessageAPI.colorize(message);
+					PlayerUtils.getServerHandle().sendMessage(player, PlaceholderUtils.parseJson(colorizedMessage));
+				}
+			}
+		}
+
+		Bukkit.getServer().getConsoleSender().sendMessage(MessageAPI.colorize(broadcastMessage));
+	}
+
+	/**
+	 * Checks and updates a player's broadcast cooldown.
+	 *
+	 * @param uuid the player's UUID
+	 * @param cooldown the cooldown duration
+	 * @return true when the broadcast is allowed
+	 */
+	private boolean checkAndMarkCooldown(UUID uuid, ParsedDuration cooldown) {
+		if (cooldown == null || cooldown.isEmpty()) {
+			return true;
+		}
+
+		Instant now = Instant.now();
+		Instant last = lastBroadcastAt.get(uuid);
+
+		if (last == null) {
+			lastBroadcastAt.put(uuid, now);
+			return true;
+		}
+
+		Instant next = cooldown.addTo(last);
+		if (!now.isBefore(next)) {
+			lastBroadcastAt.put(uuid, now);
+			return true;
+		}
+
+		return false;
+	}
+
+	/**
+	 * Adds a vote site to a player's pending batch.
+	 *
+	 * @param uuid the player's UUID
+	 * @param playerName the player's name
+	 * @param siteName the vote site
+	 * @param window the batch window
+	 */
+	private void bufferBatch(UUID uuid, String playerName, String siteName, ParsedDuration window) {
+		if (siteName != null && !siteName.isEmpty()) {
+			LinkedHashSet<String> sites = pendingSites.get(uuid);
+			if (sites == null) {
+				LinkedHashSet<String> created = new LinkedHashSet<String>();
+				sites = pendingSites.putIfAbsent(uuid, created);
+				if (sites == null) {
+					sites = created;
+				}
+			}
+
+			synchronized (sites) {
+				sites.add(siteName);
+			}
+		}
+
+		if (!pendingFlush.containsKey(uuid)) {
+			BukkitTask task = scheduleBatchFlush(uuid, playerName, window);
+			BukkitTask previous = pendingFlush.putIfAbsent(uuid, task);
+			if (previous != null) {
+				task.cancel();
+			}
+		}
+	}
+
+	/**
+	 * Schedules a pending batch flush.
+	 *
+	 * @param uuid the player's UUID
+	 * @param playerName the player's name
+	 * @param window the batch window
+	 * @return the scheduled Bukkit task
+	 */
+	private BukkitTask scheduleBatchFlush(final UUID uuid, final String playerName, ParsedDuration window) {
+		long delayMillis = window == null ? 1L : window.delayMillisFromNow();
+		long ticks = Math.max(1L, delayMillis / 50L);
+
+		return Bukkit.getScheduler().runTaskLater(plugin, new Runnable() {
+			@Override
+			public void run() {
+				try {
+					flushBatch(uuid, playerName);
+				} finally {
+					pendingFlush.remove(uuid);
+				}
+			}
+		}, ticks);
+	}
+
+	/**
+	 * Flushes a player's pending vote-site batch.
+	 *
+	 * @param uuid the player's UUID
+	 * @param playerName the player's name
+	 */
+	private void flushBatch(UUID uuid, String playerName) {
+		Set<String> sites = pendingSites.remove(uuid);
+		if (sites == null || sites.isEmpty()) {
+			return;
+		}
+
+		List<String> siteList;
+		synchronized (sites) {
+			siteList = new ArrayList<String>(sites);
+		}
+
+		broadcastNow(uuid, playerName, siteList, "batch", null);
+	}
+
+	/**
+	 * Marks and checks a player's first vote of the current day.
+	 *
+	 * @param uuid the player's UUID
+	 * @return true when this is the first vote of the day
+	 */
+	private boolean markFirstVoteOfDay(UUID uuid) {
+		LocalDate today = LocalDate.now(zoneId);
+		LocalDate last = firstVoteDay.putIfAbsent(uuid, today);
+
+		if (last == null) {
+			return true;
+		}
+
+		if (!last.equals(today)) {
+			firstVoteDay.put(uuid, today);
+			return true;
+		}
+
+		return false;
+	}
+
+	/**
+	 * Reschedules the global interval summary task when required.
+	 */
+	private void rescheduleIntervalIfNeeded() {
+		if (intervalTask != null) {
+			intervalTask.cancel();
+			intervalTask = null;
+		}
+
+		BroadcastSettings currentSettings = settings;
+		if (currentSettings == null
+				|| currentSettings.getType() != VoteBroadcastType.INTERVAL_SUMMARY_GLOBAL) {
+			return;
+		}
+
+		long delayMillis = currentSettings.getDuration() == null
+				? 1L
+				: currentSettings.getDuration().delayMillisFromNow();
+		long ticks = Math.max(1L, delayMillis / 50L);
+
+		intervalTask = Bukkit.getScheduler().runTaskTimer(plugin, new Runnable() {
+			@Override
+			public void run() {
+				broadcastIntervalSummary();
+			}
+		}, ticks, ticks);
+	}
+
+	/**
+	 * Records a vote site for the global interval summary.
+	 *
+	 * @param uuid the player's UUID
+	 * @param siteName the vote site
+	 */
+	private void recordInterval(UUID uuid, String siteName) {
+		if (siteName == null || siteName.isEmpty()) {
+			return;
+		}
+
+		LinkedHashSet<String> sites = intervalSites.get(uuid);
+		if (sites == null) {
+			LinkedHashSet<String> created = new LinkedHashSet<String>();
+			sites = intervalSites.putIfAbsent(uuid, created);
+			if (sites == null) {
+				sites = created;
+			}
+		}
+
+		synchronized (sites) {
+			sites.add(siteName);
+		}
+	}
+
+	/**
+	 * Broadcasts the global interval summary.
+	 *
+	 * The interval summary has no single voted player, so PlaceholderAPI
+	 * placeholders are left unchanged.
+	 */
+	private void broadcastIntervalSummary() {
+		BroadcastSettings currentSettings = settings;
+		if (currentSettings == null || currentSettings.isDisabled()
+				|| currentSettings.getType() != VoteBroadcastType.INTERVAL_SUMMARY_GLOBAL) {
+			return;
+		}
+
+		ConcurrentHashMap<UUID, LinkedHashSet<String>> snapshot =
+				new ConcurrentHashMap<UUID, LinkedHashSet<String>>(intervalSites);
+		intervalSites.clear();
+
+		if (snapshot.isEmpty()) {
+			return;
+		}
+
+		List<String> entries = new ArrayList<String>();
+		List<String> players = new ArrayList<String>();
+		LinkedHashSet<String> uniqueSites = new LinkedHashSet<String>();
+
+		for (Map.Entry<UUID, LinkedHashSet<String>> entry : snapshot.entrySet()) {
+			LinkedHashSet<String> siteSet = entry.getValue();
+			if (siteSet == null || siteSet.isEmpty()) {
+				continue;
+			}
+
+			String name = resolveName(entry.getKey());
+			players.add(name);
+
+			int siteCount;
+			synchronized (siteSet) {
+				siteCount = siteSet.size();
+				for (String site : siteSet) {
+					if (site != null && !site.isEmpty()) {
+						uniqueSites.add(site);
+					}
+				}
+			}
+
+			entries.add(name + " (" + siteCount + ")");
+		}
+
+		if (entries.isEmpty()) {
+			return;
+		}
+
+		String playersCsv = join(players);
+		String sitesCsv = join(new ArrayList<String>(uniqueSites));
+
+		ConcurrentHashMap<String, String> context = new ConcurrentHashMap<String, String>();
+		context.put("players", playersCsv);
+		context.put("numberofplayers", String.valueOf(players.size()));
+		context.put("sites", sitesCsv);
+		context.put("numberofsites", String.valueOf(uniqueSites.size()));
+
+		broadcastNow(null, "Server", entries, "interval", context);
+	}
+
+	/**
+	 * Creates a single-value site list.
+	 *
+	 * @param site the site name
+	 * @return the site list
+	 */
+	private List<String> single(String site) {
+		List<String> sites = new ArrayList<String>();
+		if (site != null && !site.isEmpty()) {
+			sites.add(site);
+		}
+		return sites;
+	}
+
+	/**
+	 * Applies the configured maximum number of listed sites.
+	 *
+	 * @param sites the original site list
+	 * @param currentSettings the current broadcast settings
+	 * @return the limited site list
+	 */
+	private List<String> applyMaxSites(List<String> sites, BroadcastSettings currentSettings) {
+		if (sites == null) {
+			return new ArrayList<String>();
+		}
+
+		int maximum = currentSettings.getMaxSitesListed();
+		if (maximum <= 0 || sites.size() <= maximum) {
+			return new ArrayList<String>(sites);
+		}
+
+		return new ArrayList<String>(sites.subList(0, maximum));
+	}
+
+	/**
+	 * Resolves a player's name from Bukkit.
+	 *
+	 * @param uuid the player's UUID
+	 * @return the resolved player name
+	 */
+	private String resolveName(UUID uuid) {
+		try {
+			OfflinePlayer offlinePlayer = Bukkit.getOfflinePlayer(uuid);
+			String name = offlinePlayer == null ? null : offlinePlayer.getName();
+			return name == null || name.isEmpty() ? "Player" : name;
+		} catch (Exception exception) {
+			return "Player";
+		}
+	}
+
+	/**
+	 * Joins non-empty strings with a comma and space.
+	 *
+	 * @param values the values to join
+	 * @return the joined string
+	 */
+	private String join(List<String> values) {
+		StringJoiner joiner = new StringJoiner(", ");
+		for (String value : values) {
+			if (value != null && !value.isEmpty()) {
+				joiner.add(value);
+			}
+		}
+		return joiner.toString();
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/broadcast/BroadcastSettings.java

@@ -0,0 +1,112 @@
+package com.bencodez.votingplugin.broadcast;
+
+import java.util.concurrent.TimeUnit;
+
+import org.bukkit.configuration.ConfigurationSection;
+
+import com.bencodez.simpleapi.time.ParsedDuration;
+
+/**
+ * Immutable broadcast configuration.
+ *
+ * Type: NONE disables broadcasting.
+ */
+public final class BroadcastSettings {
+
+	private final VoteBroadcastType type;
+	private final ParsedDuration duration;
+	private final int maxSitesListed;
+	private final BroadcastFormat format;
+
+	/**
+	 * Constructs a BroadcastSettings with the specified parameters.
+	 *
+	 * @param type           the broadcast type
+	 * @param duration       the broadcast duration
+	 * @param maxSitesListed the maximum number of sites to list
+	 * @param format         the broadcast format
+	 */
+	public BroadcastSettings(VoteBroadcastType type, ParsedDuration duration, int maxSitesListed,
+			BroadcastFormat format) {
+		this.type = type == null ? VoteBroadcastType.NONE : type;
+		this.duration = duration == null ? ParsedDuration.empty() : duration;
+		this.maxSitesListed = Math.max(0, maxSitesListed);
+		this.format = format == null ? new BroadcastFormat("", "", "") : format;
+	}
+
+	/**
+	 * Returns the broadcast type.
+	 *
+	 * @return the broadcast type
+	 */
+	public VoteBroadcastType getType() {
+		return type;
+	}
+
+	/**
+	 * Returns the broadcast duration.
+	 *
+	 * @return the broadcast duration
+	 */
+	public ParsedDuration getDuration() {
+		return duration;
+	}
+
+	/**
+	 * Returns the maximum number of sites to list.
+	 *
+	 * @return the maximum number of sites to list
+	 */
+	public int getMaxSitesListed() {
+		return maxSitesListed;
+	}
+
+	/**
+	 * Returns the broadcast format.
+	 *
+	 * @return the broadcast format
+	 */
+	public BroadcastFormat getFormat() {
+		return format;
+	}
+
+	/**
+	 * Returns whether broadcasting is disabled.
+	 *
+	 * @return true if broadcasting is disabled
+	 */
+	public boolean isDisabled() {
+		return type == VoteBroadcastType.NONE;
+	}
+
+	/**
+	 * Loads VoteBroadcast settings from config.yml.
+	 *
+	 * Expected structure: VoteBroadcast: Type: EVERY_VOTE Duration: 2m
+	 * MaxSitesListed: 0 Format: BroadcastMsg: '...' Header: '...' ListLine: '...'
+	 *
+	 * @param sec the configuration section to load from
+	 * @return the loaded broadcast settings
+	 */
+	public static BroadcastSettings load(ConfigurationSection sec) {
+		VoteBroadcastType type = VoteBroadcastType.parse(sec == null ? null : sec.getString("Type"),
+				VoteBroadcastType.NONE);
+
+		ParsedDuration duration = ParsedDuration.parse(sec == null ? "2m" : sec.getString("Duration", "2m"),
+				TimeUnit.MINUTES);
+
+		int maxSites = sec == null ? 0 : sec.getInt("MaxSitesListed", 0);
+
+		ConfigurationSection fmt = sec == null ? null : sec.getConfigurationSection("Format");
+
+		String broadcastMsg = fmt == null ? "&6[Vote] &aThanks &e%player% &afor voting on &e%site%&a!"
+				: fmt.getString("BroadcastMsg", "&6[Vote] &aThanks &e%player% &afor voting on &e%site%&a!");
+
+		String header = fmt == null ? "&6[Vote] &a%player% voted! &7(%sites_count%)"
+				: fmt.getString("Header", "&6[Vote] &a%player% voted! &7(%sites_count%)");
+
+		String listLine = fmt == null ? " &7- &e%site%" : fmt.getString("ListLine", " &7- &e%site%");
+
+		return new BroadcastSettings(type, duration, maxSites, new BroadcastFormat(broadcastMsg, header, listLine));
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/broadcast/VoteBroadcastType.java

@@ -0,0 +1,69 @@
+package com.bencodez.votingplugin.broadcast;
+
+import java.util.Locale;
+
+/**
+ * Defines WHEN vote broadcasts occur.
+ *
+ * Set Type: NONE to disable broadcasting entirely.
+ */
+public enum VoteBroadcastType {
+
+	/**
+	 * No vote broadcasting.
+	 */
+	NONE,
+
+	/**
+	 * Broadcast on every vote (even if the player is offline). Uses
+	 * Format.BroadcastMsg (+ optional header/list if you choose).
+	 */
+	EVERY_VOTE,
+
+	/**
+	 * Broadcast on every vote ONLY if the voting player is online. Useful when
+	 * processing offline votes but you don't want global spam for them.
+	 */
+	EVERY_VOTE_ONLINE_ONLY,
+
+	/**
+	 * Broadcast at most once per Duration per player. (Even if they vote multiple
+	 * sites inside the cooldown.)
+	 */
+	COOLDOWN_PER_PLAYER,
+
+	/**
+	 * Batch sites per player for Duration, then broadcast one message listing
+	 * sites.
+	 */
+	BATCH_WINDOW_PER_PLAYER,
+
+	/**
+	 * Broadcast only the first vote of the day per player (calendar day).
+	 */
+	FIRST_VOTE_OF_DAY,
+
+	/**
+	 * Every Duration, broadcast a global summary of who voted and how many sites.
+	 * Uses context placeholders: %players%, %numberofplayers%, %sites%,
+	 * %numberofsites%.
+	 */
+	INTERVAL_SUMMARY_GLOBAL;
+
+	/**
+	 * Parses a vote broadcast type from a string.
+	 * @param s the string to parse
+	 * @param def the default value if parsing fails
+	 * @return the parsed broadcast type or default
+	 */
+	public static VoteBroadcastType parse(String s, VoteBroadcastType def) {
+		if (s == null || s.trim().isEmpty()) {
+			return def;
+		}
+		try {
+			return VoteBroadcastType.valueOf(s.trim().toUpperCase(Locale.ROOT));
+		} catch (Exception ignored) {
+			return def;
+		}
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/executers/CommandAdminVote.java

@@ -16,6 +16,11 @@ public class CommandAdminVote implements CommandExecutor {
 
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructs a new CommandAdminVote instance.
+	 *
+	 * @param plugin the main plugin instance
+	 */
 	public CommandAdminVote(VotingPluginMain plugin) {
 		this.plugin = plugin;
 	}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/executers/CommandAliases.java

@@ -25,6 +25,12 @@ public class CommandAliases implements CommandExecutor {
 	/** The plugin. */
 	private VotingPluginMain plugin = VotingPluginMain.plugin;
 
+	/**
+	 * Constructs a new CommandAliases instance.
+	 *
+	 * @param cmdHandle the command handler
+	 * @param adminCommand whether this is an admin command
+	 */
 	public CommandAliases(CommandHandler cmdHandle, boolean adminCommand) {
 		this.cmdHandle = cmdHandle;
 		this.adminCommand = adminCommand;

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/AdminGUI.java

@@ -19,26 +19,32 @@ import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueLi
 import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueNumber;
 import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueString;
 import com.bencodez.advancedcore.api.item.ItemBuilder;
-import com.bencodez.advancedcore.api.valuerequest.InputMethod;
-import com.bencodez.advancedcore.api.valuerequest.ValueRequest;
-import com.bencodez.advancedcore.api.valuerequest.ValueRequestBuilder;
-import com.bencodez.advancedcore.api.valuerequest.listeners.StringListener;
+import com.bencodez.simpleapi.valuerequest.InputMethod;
+import com.bencodez.simpleapi.valuerequest.StringListener;
+import com.bencodez.simpleapi.valuerequest.ValueRequest;
 import com.bencodez.advancedcore.api.yml.editor.ConfigEditor;
 import com.bencodez.advancedcore.command.gui.RewardEditGUI;
 import com.bencodez.simpleapi.array.ArrayUtils;
 import com.bencodez.simpleapi.player.PlayerUtils;
 import com.bencodez.votingplugin.VotingPluginMain;
 import com.bencodez.votingplugin.commands.gui.admin.AdminVoteVoteParty;
-import com.bencodez.votingplugin.commands.gui.admin.cumulative.AdminVoteCumulative;
-import com.bencodez.votingplugin.commands.gui.admin.milestones.AdminVoteMilestones;
+import com.bencodez.votingplugin.commands.gui.admin.milestones.AdminVoteVoteMilestones;
 import com.bencodez.votingplugin.commands.gui.admin.voteshop.AdminVoteVoteShop;
 import com.bencodez.votingplugin.events.PlayerVoteEvent;
-import com.bencodez.votingplugin.objects.VoteSite;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
+/**
+ * Admin GUI handler for the voting plugin.
+ */
 public class AdminGUI {
 
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructor for AdminGUI.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 */
 	public AdminGUI(VotingPluginMain plugin) {
 		this.plugin = plugin;
 	}
@@ -58,14 +64,14 @@ public class AdminGUI {
 			public void onClick(ClickEvent event) {
 				Player player = event.getPlayer();
 				if (event.getClick().equals(ClickType.MIDDLE)) {
-					new ValueRequest().requestString(player, new StringListener() {
+					new ValueRequest(plugin, plugin.getDialogService(), null).requestString(player, "", null, true, "Enter vote site", new StringListener() {
 
 						@Override
 						public void onInput(Player player, String value) {
 							plugin.getConfigVoteSites().generateVoteSite(value);
 							player.sendMessage("Generated site");
 							plugin.reload();
-							openAdminGUIVoteSiteSite(player, plugin.getVoteSite(value, true));
+							openAdminGUIVoteSiteSite(player, plugin.getVoteSiteManager().getVoteSite(value, true));
 						}
 					});
 				} else {
@@ -82,19 +88,11 @@ public class AdminGUI {
 			}
 		});
 
-		buttons.add(new BInventoryButton(new ItemBuilder(Material.DIAMOND_BLOCK, 1).setName("&cEdit Milestones")) {
+		buttons.add(new BInventoryButton(new ItemBuilder(Material.DIAMOND_BLOCK, 1).setName("&cEdit VoteMilestones")) {
 
 			@Override
 			public void onClick(ClickEvent clickEvent) {
-				new AdminVoteMilestones(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
-			}
-		});
-
-		buttons.add(new BInventoryButton(new ItemBuilder(Material.COBBLESTONE, 1).setName("&cEdit Cumulative")) {
-
-			@Override
-			public void onClick(ClickEvent clickEvent) {
-				new AdminVoteCumulative(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
+				new AdminVoteVoteMilestones(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
 			}
 		});
 
@@ -226,6 +224,9 @@ public class AdminGUI {
 		return buttons;
 	}
 
+	/**
+	 * Load hook to add admin GUI buttons.
+	 */
 	public void loadHook() {
 		for (BInventoryButton b : adminGUIButtons()) {
 			com.bencodez.advancedcore.command.gui.AdminGUI.getInstance().addButton(b);
@@ -240,7 +241,7 @@ public class AdminGUI {
 	public void openAdminGUIVoteSites(Player player) {
 		BInventory inv = new BInventory("VoteSites");
 		int count = 0;
-		for (VoteSite voteSite : plugin.getVoteSites()) {
+		for (VoteSite voteSite : plugin.getVoteSiteManager().getVoteSites()) {
 			ArrayList<String> lore = new ArrayList<>();
 			lore.add("Enabled: " + voteSite.isEnabled());
 			lore.add("Priority: " + voteSite.getPriority());
@@ -249,7 +250,6 @@ public class AdminGUI {
 			lore.add("ServiceSite: " + voteSite.getServiceSite());
 			lore.add("VoteURL: " + voteSite.getVoteURL());
 			lore.add("VoteDelay: " + voteSite.getVoteDelay());
-			lore.add("VoteDelayMin: " + voteSite.getVoteDelayMin());
 
 			inv.addButton(count,
 					new BInventoryButton(voteSite.getKey(), ArrayUtils.convert(lore), new ItemStack(Material.STONE)) {
@@ -285,25 +285,25 @@ public class AdminGUI {
 				for (Player p : Bukkit.getOnlinePlayers()) {
 					playerNames.add(p.getName());
 				}
-				new ValueRequestBuilder(new StringListener() {
+				new ValueRequest(plugin, plugin.getDialogService(), InputMethod.INVENTORY).requestString(
+						event.getWhoClicked(), "", playerNames, true, "Select player", new StringListener() {
 
-					@Override
-					public void onInput(Player player, String value) {
-						Object ob = PlayerUtils.getPlayerMeta(plugin, player, "VoteSite");
-						if (ob != null) {
-							VoteSite site = (VoteSite) ob;
-							PlayerVoteEvent voteEvent = new PlayerVoteEvent(site, value, site.getServiceSite(), false);
-							plugin.getVoteTimer().submit(new Runnable() {
+							@Override
+							public void onInput(Player player, String value) {
+								Object ob = PlayerUtils.getPlayerMeta(plugin, player, "VoteSite");
+								if (ob != null) {
+									VoteSite site = (VoteSite) ob;
+									PlayerVoteEvent voteEvent = new PlayerVoteEvent(site, value, site.getServiceSite(), false);
+									plugin.getVoteTimer().submit(new Runnable() {
 
-								@Override
-								public void run() {
-									plugin.getServer().getPluginManager().callEvent(voteEvent);
+										@Override
+										public void run() {
+											plugin.getServer().getPluginManager().callEvent(voteEvent);
+										}
+									});
 								}
-							});
-						}
-					}
-				}, ArrayUtils.convert(playerNames)).usingMethod(InputMethod.INVENTORY).allowCustomOption(true)
-						.request(event.getWhoClicked());
+							}
+						});
 			}
 		});
 
@@ -349,24 +349,13 @@ public class AdminGUI {
 			}
 		}));
 
-		inv.addButton(new EditGUIButton(new EditGUIValueNumber("VoteDelay", voteSite.getVoteDelay()) {
+		inv.addButton(new EditGUIButton(new EditGUIValueString("VoteDelay", voteSite.getVoteDelay()) {
 
 			@Override
-			public void setValue(Player player, Number num) {
+			public void setValue(Player player, String value) {
 				VoteSite voteSite = (VoteSite) getInv().getMeta(player, "VoteSite");
 				String siteName = voteSite.getKey();
-				plugin.getConfigVoteSites().setVoteDelay(siteName, num.intValue());
-				plugin.reload();
-			}
-		}));
-
-		inv.addButton(new EditGUIButton(new EditGUIValueNumber("VoteDelayMin", voteSite.getVoteDelay()) {
-
-			@Override
-			public void setValue(Player player, Number num) {
-				VoteSite voteSite = (VoteSite) getInv().getMeta(player, "VoteSite");
-				String siteName = voteSite.getKey();
-				plugin.getConfigVoteSites().setVoteDelay(siteName, num.intValue());
+				plugin.getConfigVoteSites().setVoteDelay(siteName, value);
 				plugin.reload();
 			}
 		}));
@@ -377,7 +366,7 @@ public class AdminGUI {
 			public void setValue(Player player, Number num) {
 				VoteSite voteSite = (VoteSite) getInv().getMeta(player, "VoteSite");
 				String siteName = voteSite.getKey();
-				plugin.getConfigVoteSites().setVoteDelay(siteName, num.intValue());
+				plugin.getConfigVoteSites().setVoteDelayDailyHour(siteName, num.intValue());
 				plugin.reload();
 			}
 		}));
@@ -463,4 +452,4 @@ public class AdminGUI {
 
 		inv.openInventory(player);
 	}
-}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/AdminVoteConfirmation.java

@@ -14,12 +14,22 @@ import com.bencodez.advancedcore.api.inventory.BInventoryButton;
 import com.bencodez.advancedcore.api.item.ItemBuilder;
 import com.bencodez.votingplugin.VotingPluginMain;
 
+/**
+ * Abstract class for admin vote confirmation dialogs.
+ */
 public abstract class AdminVoteConfirmation extends GUIHandler {
 
 	@SuppressWarnings("unused")
 	private VotingPluginMain plugin;
 	private String title;
 
+	/**
+	 * Constructor for AdminVoteConfirmation.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 * @param title  the title of the confirmation dialog
+	 */
 	public AdminVoteConfirmation(VotingPluginMain plugin, CommandSender player, String title) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -31,6 +41,11 @@ public abstract class AdminVoteConfirmation extends GUIHandler {
 		return null;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
 	@Override
 	public void onBook(Player player) {
 	}
@@ -60,8 +75,18 @@ public abstract class AdminVoteConfirmation extends GUIHandler {
 		inv.openInventory(player);
 	}
 
+	/**
+	 * Called when the user confirms the action.
+	 *
+	 * @param p the player who confirmed
+	 */
 	public abstract void onConfirm(Player p);
 
+	/**
+	 * Called when the user denies the action.
+	 *
+	 * @param p the player who denied
+	 */
 	public abstract void onDeny(Player p);
 
 	@Override

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/AdminVoteHelp.java

@@ -15,11 +15,21 @@ import com.bencodez.votingplugin.VotingPluginMain;
 
 import net.md_5.bungee.api.chat.TextComponent;
 
+/**
+ * Admin help GUI handler.
+ */
 public class AdminVoteHelp extends GUIHandler {
 
 	private int page;
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructor for AdminVoteHelp.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 * @param page   the page number to display
+	 */
 	public AdminVoteHelp(VotingPluginMain plugin, CommandSender player, int page) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -54,6 +64,11 @@ public class AdminVoteHelp extends GUIHandler {
 		return msg;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
 	/**
 	 * Admin help text.
 	 *

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/AdminVotePerms.java

@@ -15,18 +15,36 @@ import com.bencodez.advancedcore.api.gui.GUIMethod;
 import com.bencodez.simpleapi.array.ArrayUtils;
 import com.bencodez.votingplugin.VotingPluginMain;
 
+/**
+ * Admin permissions GUI handler.
+ */
 public class AdminVotePerms extends GUIHandler {
 
 	private int page;
 	private String playerName;
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructor for AdminVotePerms.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 * @param page   the page number
+	 */
 	public AdminVotePerms(VotingPluginMain plugin, CommandSender player, int page) {
 		super(plugin, player);
 		this.plugin = plugin;
 		this.page = page;
 	}
 
+	/**
+	 * Constructor for AdminVotePerms with player name.
+	 *
+	 * @param plugin     the VotingPluginMain instance
+	 * @param player     the command sender
+	 * @param page       the page number
+	 * @param playerName the player name to check
+	 */
 	public AdminVotePerms(VotingPluginMain plugin, CommandSender player, int page, String playerName) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -39,6 +57,17 @@ public class AdminVotePerms extends GUIHandler {
 		return null;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	/**
+	 * List permissions for a sender.
+	 *
+	 * @param sender the command sender
+	 * @return array of permission strings
+	 */
 	public String[] listPerms(CommandSender sender) {
 		ArrayList<String> msg = new ArrayList<>();
 
@@ -113,6 +142,14 @@ public class AdminVotePerms extends GUIHandler {
 		return ArrayUtils.convert(text);
 	}
 
+	/**
+	 * List permissions for a specific player.
+	 *
+	 * @param sender the command sender
+	 * @param player the player name
+	 * @param page   the page number
+	 * @return list of permission strings
+	 */
 	public ArrayList<String> listPerms(CommandSender sender, String player, int page) {
 		Player p = Bukkit.getPlayer(player);
 		ArrayList<String> text = new ArrayList<>();
@@ -179,6 +216,12 @@ public class AdminVotePerms extends GUIHandler {
 
 	}
 
+	/**
+	 * List permissions in developer format.
+	 *
+	 * @param sender the command sender
+	 * @return array of permission strings in developer format
+	 */
 	public String[] listPermsDev(CommandSender sender) {
 		ArrayList<String> msg = new ArrayList<>();
 		msg.add("Command");

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/AdminVotePlaceholders.java

@@ -18,10 +18,19 @@ import com.bencodez.votingplugin.user.VotingPluginUser;
 
 import xyz.upperlevel.spigot.book.BookUtil;
 
+/**
+ * Admin placeholders GUI handler.
+ */
 public class AdminVotePlaceholders extends GUIHandler {
 
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructor for AdminVotePlaceholders.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
 	public AdminVotePlaceholders(VotingPluginMain plugin, CommandSender player) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -32,6 +41,11 @@ public class AdminVotePlaceholders extends GUIHandler {
 		return null;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
 	@Override
 	public void onBook(Player player) {
 		BookWrapper book = new BookWrapper("Placeholders");

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/AdminVotePlaceholdersPlayer.java

@@ -18,11 +18,21 @@ import com.bencodez.votingplugin.user.VotingPluginUser;
 
 import xyz.upperlevel.spigot.book.BookUtil;
 
+/**
+ * Admin placeholders player GUI handler.
+ */
 public class AdminVotePlaceholdersPlayer extends GUIHandler {
 
 	private VotingPluginMain plugin;
 	private VotingPluginUser user;
 
+	/**
+	 * Constructor for AdminVotePlaceholdersPlayer.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 * @param user   the voting plugin user
+	 */
 	public AdminVotePlaceholdersPlayer(VotingPluginMain plugin, CommandSender player, VotingPluginUser user) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -34,6 +44,11 @@ public class AdminVotePlaceholdersPlayer extends GUIHandler {
 		return null;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
 	@Override
 	public void onBook(Player player) {
 		BookWrapper book = new BookWrapper("Placeholders");
@@ -73,9 +88,6 @@ public class AdminVotePlaceholdersPlayer extends GUIHandler {
 		ArrayList<String> msg = new ArrayList<>();
 		msg.add("&cPlaceholders:");
 		VotingPluginUser placeholderUser = user;
-		if (plugin.getConfigFile().isUsePrimaryAccountForPlaceholders() && user.hasPrimaryAccount()) {
-			placeholderUser = plugin.getVotingPluginUserManager().getVotingPluginUser(user.getPrimaryAccount());
-		}
 		for (PlaceHolder<VotingPluginUser> placeholder : plugin.getPlaceholders().getPlaceholders()) {
 			String identifier = placeholder.getIdentifier().toLowerCase();
 			if (identifier.endsWith("_")) {

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/AdminVoteTopPoints.java

@@ -21,11 +21,15 @@ import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
 import com.bencodez.advancedcore.api.inventory.BInventoryButton;
 import com.bencodez.advancedcore.api.item.ItemBuilder;
 import com.bencodez.advancedcore.api.rewards.RewardBuilder;
+import com.bencodez.advancedcore.api.user.UserDataFetchMode;
 import com.bencodez.votingplugin.VotingPluginMain;
 import com.bencodez.votingplugin.commands.gui.player.VoteGUI;
 import com.bencodez.votingplugin.topvoter.TopVoterPlayer;
 import com.bencodez.votingplugin.user.VotingPluginUser;
 
+/**
+ * Admin top points GUI handler.
+ */
 public class AdminVoteTopPoints extends GUIHandler {
 
 	@SuppressWarnings("unused")
@@ -33,6 +37,14 @@ public class AdminVoteTopPoints extends GUIHandler {
 	private VotingPluginMain plugin;
 	private VotingPluginUser user;
 
+	/**
+	 * Constructor for AdminVoteTopPoints.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 * @param user   the voting plugin user
+	 * @param page   the page number
+	 */
 	public AdminVoteTopPoints(VotingPluginMain plugin, CommandSender player, VotingPluginUser user, int page) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -45,6 +57,11 @@ public class AdminVoteTopPoints extends GUIHandler {
 		return null;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
 	@Override
 	public void onBook(Player player) {
 	}
@@ -63,7 +80,7 @@ public class AdminVoteTopPoints extends GUIHandler {
 			for (String uuid : plugin.getVotingPluginUserManager().getAllUUIDs()) {
 				VotingPluginUser vpUser = plugin.getVotingPluginUserManager()
 						.getVotingPluginUser(UUID.fromString(uuid));
-				vpUser.dontCache();
+				vpUser.userDataFetechMode(UserDataFetchMode.NO_CACHE);
 				int points = vpUser.getPoints();
 				if (points > 0) {
 					topPoints1.put(vpUser.getTopVoterPlayer(), points);

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/AdminVoteVoteParty.java

@@ -17,15 +17,25 @@ import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueLi
 import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueNumber;
 import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueString;
 import com.bencodez.advancedcore.api.item.ItemBuilder;
-import com.bencodez.advancedcore.api.valuerequest.ValueRequestBuilder;
-import com.bencodez.advancedcore.api.valuerequest.listeners.NumberListener;
 import com.bencodez.advancedcore.command.gui.RewardEditGUI;
+import com.bencodez.simpleapi.valuerequest.InputMethod;
+import com.bencodez.simpleapi.valuerequest.NumberListener;
+import com.bencodez.simpleapi.valuerequest.ValueRequest;
 import com.bencodez.votingplugin.VotingPluginMain;
 
+/**
+ * Admin vote party GUI handler.
+ */
 public class AdminVoteVoteParty extends GUIHandler {
 
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructor for AdminVoteVoteParty.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
 	public AdminVoteVoteParty(VotingPluginMain plugin, CommandSender player) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -45,12 +55,16 @@ public class AdminVoteVoteParty extends GUIHandler {
 
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
 	@Override
 	public void onChest(Player player) {
 		EditGUI inv = new EditGUI("Edit VoteParty");
 		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteParty");
 
-		// to add
 		inv.addButton(new EditGUIButton(new ItemBuilder(Material.PAPER, 1),
 				new EditGUIValueBoolean("Enabled", plugin.getSpecialRewardsConfig().isVotePartyEnabled()) {
 
@@ -83,15 +97,21 @@ public class AdminVoteVoteParty extends GUIHandler {
 
 			@Override
 			public void onClick(ClickEvent clickEvent) {
-				new ValueRequestBuilder(new NumberListener() {
+				ArrayList<Number> options = new ArrayList<Number>();
+				options.add(Integer.valueOf(0));
+				options.add(Integer.valueOf(10));
+				options.add(Integer.valueOf(50));
+				options.add(Integer.valueOf(100));
 
-					@Override
-					public void onInput(Player player, Number value) {
-						plugin.getServerData().setVotePartyExtraRequired(value.intValue());
-					}
-				}, new Number[] { 0, 10, 50, 100 })
-						.currentValue("" + plugin.getServerData().getVotePartyExtraRequired()).allowCustomOption(true)
-						.request(clickEvent.getPlayer());
+				new ValueRequest(plugin, plugin.getDialogService(), InputMethod.INVENTORY).requestNumber(
+						clickEvent.getPlayer(), Integer.valueOf(plugin.getServerData().getVotePartyExtraRequired()),
+						options, true, "Set extra votes", new NumberListener() {
+
+							@Override
+							public void onInput(Player player, Number value) {
+								plugin.getServerData().setVotePartyExtraRequired(value.intValue());
+							}
+						});
 
 			}
 		});
@@ -215,8 +235,6 @@ public class AdminVoteVoteParty extends GUIHandler {
 			}
 		});
 
-		// implement item reward?
-
 		inv.openInventory(player);
 	}
 
@@ -231,4 +249,4 @@ public class AdminVoteVoteParty extends GUIHandler {
 		plugin.reload();
 	}
 
-}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/AdminVoteVotePlayer.java

@@ -12,13 +12,23 @@ import com.bencodez.advancedcore.api.inventory.BInventoryButton;
 import com.bencodez.advancedcore.api.inventory.editgui.EditGUI;
 import com.bencodez.votingplugin.VotingPluginMain;
 import com.bencodez.votingplugin.events.PlayerVoteEvent;
-import com.bencodez.votingplugin.objects.VoteSite;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
+/**
+ * Admin vote player GUI handler.
+ */
 public class AdminVoteVotePlayer extends GUIHandler {
 
 	private String playerName;
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructor for AdminVoteVotePlayer.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 * @param playerName the player name
+	 */
 	public AdminVoteVotePlayer(VotingPluginMain plugin, CommandSender player, String playerName) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -44,7 +54,7 @@ public class AdminVoteVotePlayer extends GUIHandler {
 		EditGUI inv = new EditGUI("Trigger vote for " + playerName);
 		inv.requirePermission("VotingPlugin.Commands.AdminVote.Vote|VotingPlugin.Admin");
 
-		for (VoteSite site : plugin.getVoteSitesEnabled()) {
+		for (VoteSite site : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 			inv.addButton(new BInventoryButton(site.getItem().setName(site.getKey())) {
 
 				@Override
@@ -71,6 +81,11 @@ public class AdminVoteVotePlayer extends GUIHandler {
 
 		inv.openInventory(player);
 	}
+	
+	@Override
+	public void onDialog(Player player) {
+		
+	}
 
 	@Override
 	public void open() {

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/milestones/AdminVoteVoteMilestoneRemove.java

@@ -15,11 +15,20 @@ import com.bencodez.advancedcore.api.item.ItemBuilder;
 import com.bencodez.votingplugin.VotingPluginMain;
 import com.bencodez.votingplugin.commands.gui.admin.AdminVoteConfirmation;
 
-public class AdminVoteMilestoneRemove extends GUIHandler {
+/**
+ * Admin vote milestone remove GUI handler.
+ */
+public class AdminVoteVoteMilestoneRemove extends GUIHandler {
 
 	private VotingPluginMain plugin;
 
-	public AdminVoteMilestoneRemove(VotingPluginMain plugin, CommandSender player) {
+	/**
+	 * Constructor for AdminVoteVoteMilestoneRemove.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
+	public AdminVoteVoteMilestoneRemove(VotingPluginMain plugin, CommandSender player) {
 		super(plugin, player);
 		this.plugin = plugin;
 	}
@@ -38,11 +47,16 @@ public class AdminVoteMilestoneRemove extends GUIHandler {
 
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
 	@Override
 	public void onChest(Player player) {
-		BInventory inv = new BInventory("Remove milestones");
-		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.MileStones");
-		for (final String votes : plugin.getSpecialRewardsConfig().getMilestoneVotes()) {
+		BInventory inv = new BInventory("Remove VoteMilestones");
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteMilestones");
+		for (final String votes : plugin.getVoteMilestonesManager().getConfig().getMilestones().keySet()) {
 			inv.addButton(new BInventoryButton(
 					new ItemBuilder(Material.PAPER, 1).setName(votes).addLoreLine("&c&lClick to remove")) {
 
@@ -52,14 +66,14 @@ public class AdminVoteMilestoneRemove extends GUIHandler {
 
 						@Override
 						public void onConfirm(Player p) {
-							plugin.getSpecialRewardsConfig().removeMilestone(votes);
+							plugin.getSpecialRewardsConfig().removeVoteMilestone(votes);
 							p.sendMessage("Removed milestone " + votes);
 							plugin.reload();
 						}
 
 						@Override
 						public void onDeny(Player p) {
-							new AdminVoteMilestones(plugin, p);
+							new AdminVoteVoteMilestones(plugin, p);
 						}
 					}.open();
 

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/milestones/AdminVoteVoteMilestones.java

@@ -0,0 +1,120 @@
+package com.bencodez.votingplugin.commands.gui.admin.milestones;
+
+import java.util.ArrayList;
+import java.util.Set;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.advancedcore.command.gui.RewardEditGUI;
+import com.bencodez.simpleapi.valuerequest.InputMethod;
+import com.bencodez.simpleapi.valuerequest.NumberListener;
+import com.bencodez.simpleapi.valuerequest.StringListener;
+import com.bencodez.simpleapi.valuerequest.ValueRequest;
+import com.bencodez.votingplugin.VotingPluginMain;
+
+/**
+ * Admin vote milestones GUI handler.
+ */
+public class AdminVoteVoteMilestones extends GUIHandler {
+
+	private VotingPluginMain plugin;
+
+	/**
+	 * Constructor for AdminVoteVoteMilestones.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
+	public AdminVoteVoteMilestones(VotingPluginMain plugin, CommandSender player) {
+		super(plugin, player);
+		this.plugin = plugin;
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		BInventory inv = new BInventory("Edit VoteMilestones");
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteMilestones");
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER)
+				.setName("&cEdit existing vote milestone rewards (Legacy milestones not included)")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				Set<String> keys = plugin.getVoteMilestonesManager().getConfig().getMilestones().keySet();
+				ArrayList<String> milestoneKeys = new ArrayList<String>();
+				for (String key : keys) {
+					if (!key.startsWith("Legacy_")) {
+						milestoneKeys.add(key);
+					}
+				}
+
+				new ValueRequest(plugin, plugin.getDialogService(), InputMethod.INVENTORY).requestString(
+						clickEvent.getPlayer(), "", milestoneKeys, false, "Select milestone", new StringListener() {
+
+							@Override
+							public void onInput(Player player, String value) {
+								RewardEditGUI.getInstance().openRewardGUI(clickEvent.getPlayer(),
+										plugin.getRewardHandler().getDirectlyDefined("VoteMilestones." + value + ".Rewards"));
+							}
+						});
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.EMERALD_BLOCK).setName("&aAdd milestone")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new ValueRequest(plugin, plugin.getDialogService(), null).requestNumber(player, 0, null, true,
+						"Enter milestone", new NumberListener() {
+
+							@Override
+							public void onInput(Player player, Number value) {
+								plugin.getSpecialRewardsConfig().setVoteMilestone(value.intValue());
+								plugin.reload();
+							}
+						});
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.REDSTONE_BLOCK).setName("&cRemove milestone")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteMilestoneRemove(plugin, clickEvent.getPlayer()).open();
+			}
+		});
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogEventSelect.java

@@ -0,0 +1,169 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: Select an event filter, then open AdminVoteLogRecent (filtered).
+ */
+public class AdminVoteLogEventSelect extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int days;
+	private final int page;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogEventSelect.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param days   the number of days to filter
+	 */
+	public AdminVoteLogEventSelect(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days) {
+		this(plugin, sender, table, user, days, 0);
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	/**
+	 * Constructor for AdminVoteLogEventSelect with page.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogEventSelect(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		this.days = days;
+		this.page = Math.max(0, page);
+
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Events";
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			List<VoteLogMysqlTable.VoteLogEvent> events = Arrays.asList(VoteLogMysqlTable.VoteLogEvent.values());
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(events.size(), start + PAGE_SIZE);
+
+			if (start >= events.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo events")
+						.addLoreLine("&7No events on this page.").addLoreLine("&7Try going back a page.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					VoteLogMysqlTable.VoteLogEvent ev = events.get(i);
+					inv.addButton(makeEventButton(ev));
+				}
+			}
+
+			// back button
+			if (user != null && plugin.getGui().isChestVoteTopBackButton()) {
+				inv.getPageButtons().add(plugin.getCommandLoader().getBackButton(user).setSlot(7));
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makeEventButton(VoteLogMysqlTable.VoteLogEvent ev) {
+		ItemBuilder item = new ItemBuilder(Material.BOOK).setName("&a" + ev.name())
+				.addLoreLine("&7Click to view recent logs filtered by this event")
+				.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time");
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogRecent(plugin, clickEvent.getPlayer(), table, user, 0, days, ev).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogHelpers.java

@@ -0,0 +1,125 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.text.SimpleDateFormat;
+import java.util.Date;
+
+import org.bukkit.Material;
+
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Helper class for admin vote log GUI operations.
+ */
+public class AdminVoteLogHelpers {
+	/**
+	 * Get the material icon for a vote log event.
+	 *
+	 * @param event the vote log event
+	 * @param status the status of the vote
+	 * @return the material to use for the icon
+	 */
+	public static Material getMaterialForEvent(VoteLogMysqlTable.VoteLogEvent event, String status) {
+		// Cached entries still override to chest (keeps your current behavior)
+		if ("CACHED".equalsIgnoreCase(status)) {
+			return Material.CHEST;
+		}
+
+		if (event == null) {
+			return Material.PAPER;
+		}
+
+		switch (event) {
+		case VOTE_RECEIVED:
+			return Material.EMERALD;
+
+		case VOTEMILESTONE:
+			return Material.ANVIL;
+
+		case VOTE_STREAK_REWARD:
+			return Material.FIREWORK_ROCKET;
+
+		case TOP_VOTER_REWARD:
+			return Material.GOLD_BLOCK;
+
+		default:
+			return Material.PAPER;
+		}
+	}
+
+	/**
+	 * Get the color code for a vote log event.
+	 *
+	 * @param event the vote log event
+	 * @return the color code string
+	 */
+	public static String getEventColor(VoteLogMysqlTable.VoteLogEvent event) {
+		if (event == null) {
+			return "&7";
+		}
+
+		switch (event) {
+		case VOTE_RECEIVED:
+			return "&a";
+		case VOTEMILESTONE:
+			return "&6";
+
+		case VOTE_STREAK_REWARD:
+			return "&d";
+
+		case TOP_VOTER_REWARD:
+			return "&c";
+
+		default:
+			return "&7";
+		}
+	}
+
+	/**
+	 * Returns a safe string, converting null to empty string.
+	 *
+	 * @param s the string to check
+	 * @return the string or empty string if null
+	 */
+	public static String safe(String s) {
+		return s == null ? "" : s;
+	}
+
+	/**
+	 * Checks if a string is not null and not empty.
+	 *
+	 * @param s the string to check
+	 * @return true if the string is not empty
+	 */
+	public static boolean notEmpty(String s) {
+		return s != null && !s.trim().isEmpty();
+	}
+
+	/**
+	 * Formats a timestamp in milliseconds to a readable date string.
+	 *
+	 * @param millis the timestamp in milliseconds
+	 * @return the formatted date string
+	 */
+	public static String formatTime(long millis) {
+		try {
+			SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
+			return sdf.format(new Date(millis));
+		} catch (Exception e) {
+			return String.valueOf(millis);
+		}
+	}
+
+	/**
+	 * Returns a shortened version of a UUID string.
+	 *
+	 * @param uuid the UUID string
+	 * @return the first 8 characters of the UUID or "unknown"
+	 */
+	public static String shortUuid(String uuid) {
+		if (uuid == null || uuid.isEmpty()) {
+			return "unknown";
+		}
+		return uuid.length() > 8 ? uuid.substring(0, 8) : uuid;
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogMenu.java

@@ -0,0 +1,208 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin vote log menu GUI handler.
+ */
+public class AdminVoteLogMenu extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int days; // window used by selectors/stats (0 = all time)
+
+	// Default to "voting" (Vote received)
+	private final VoteLogMysqlTable.VoteLogEvent defaultEvent = VoteLogMysqlTable.VoteLogEvent.VOTE_RECEIVED;
+
+	/**
+	 * Constructor for AdminVoteLogMenu.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param days   the number of days to filter
+	 */
+	public AdminVoteLogMenu(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table, int days) {
+		this(plugin, sender, table, null, days);
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	/**
+	 * Constructor for AdminVoteLogMenu with user.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param days   the number of days to filter
+	 */
+	public AdminVoteLogMenu(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+		this.days = Math.max(0, days);
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Admin";
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.NAME_TAG).setName("&aVotes by Player")
+					.addLoreLine("&7List stored player names").addLoreLine("&7Click a player to view their votelog")) {
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteLogPlayerSelect(plugin, clickEvent.getPlayer(), table, user, days, 0).open();
+				}
+			});
+
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.NAME_TAG).setName("&aVotes by Player (Online)")
+					.addLoreLine("&7List online players").addLoreLine("&7Click a player to view their votelog")) {
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteLogPlayerSelectOnline(plugin, clickEvent.getPlayer(), table, user, days, 0).open();
+				}
+			});
+
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&aVotes by Service")
+					.addLoreLine("&7List all services found").addLoreLine("&7Click a service to view votelog")) {
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteLogServiceSelect(plugin, clickEvent.getPlayer(), table, user, days, 0).open();
+				}
+			});
+
+			// NEW: Votes by Server
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.COMPASS).setName("&aVotes by Server")
+					.addLoreLine("&7List all servers found").addLoreLine("&7Click a server to view votelog")) {
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteLogServerSelect(plugin, clickEvent.getPlayer(), table, user, days, 0).open();
+				}
+			});
+
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.MAP).setName("&aStats")
+					.addLoreLine("&7Overview counts/uniques/top services")
+					.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time")) {
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteLogStats(plugin, clickEvent.getPlayer(), table, user, days, 10).open();
+				}
+			});
+
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.CLOCK).setName("&aRecent Logs")
+					.addLoreLine("&7Recent logs filtered by event").addLoreLine("&7Default: &f" + defaultEvent.name())
+					.addLoreLine("&8(Use bottom buttons to switch event)")) {
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					// Open recent with default event filter
+					new AdminVoteLogRecent(plugin, clickEvent.getPlayer(), table, user, 0, days, defaultEvent).open();
+				}
+			});
+
+			addEventSwitchButtons(inv);
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private void addEventSwitchButtons(BInventory inv) {
+		inv.getPageButtons().add(new BInventoryButton(new ItemBuilder(Material.LIME_DYE)
+				.setName("&aEvent: &fVOTE_RECEIVED").addLoreLine("&7Show recent vote received events")) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogRecent(plugin, clickEvent.getPlayer(), table, user, 0, days,
+						VoteLogMysqlTable.VoteLogEvent.VOTE_RECEIVED).open();
+			}
+		}.setSlot(3));
+
+		// More... (open selector)
+		inv.getPageButtons().add(new BInventoryButton(
+				new ItemBuilder(Material.BOOK).setName("&aEvent: &fMore...").addLoreLine("&7Pick any event filter")) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogEventSelect(plugin, clickEvent.getPlayer(), table, user, days).open();
+			}
+		}.setSlot(4));
+
+		// All events
+		inv.getPageButtons().add(new BInventoryButton(new ItemBuilder(Material.GRAY_DYE).setName("&aEvent: &fALL")
+				.addLoreLine("&7Show recent logs for all events")) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogRecent(plugin, clickEvent.getPlayer(), table, user, 0, days, null).open();
+			}
+		}.setSlot(5));
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogPlayer.java

@@ -0,0 +1,185 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: VoteLog entries for a given player (paged).
+ *
+ * Uses VoteLogMysqlTable instance passed in from CommandLoader.
+ *
+ * Supports input as player name OR uuid string (you decide in CommandLoader
+ * which constructor to call).
+ */
+public class AdminVoteLogPlayer extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private final int page;
+
+	private final String playerName;
+
+	private final int days;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogPlayer.
+	 *
+	 * @param plugin     the VotingPluginMain instance
+	 * @param sender     the command sender
+	 * @param table      the vote log table
+	 * @param playerName the player name or UUID
+	 * @param days       the number of days to filter
+	 * @param page       the page number
+	 */
+	public AdminVoteLogPlayer(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table, String playerName,
+			int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.playerName = playerName;
+		this.days = days;
+		this.page = Math.max(0, page);
+
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Player";
+			if (playerName != null && !playerName.isEmpty()) {
+				title += " &7(" + playerName + ")";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			int needed = (page + 1) * PAGE_SIZE;
+
+			List<VoteLogMysqlTable.VoteLogEntry> rows = table.getByPlayerName(playerName, days, needed);
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(rows.size(), start + PAGE_SIZE);
+
+			if (start >= rows.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo entries")
+						.addLoreLine("&7No vote log entries on this page.").addLoreLine("&7Try going back a page.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					inv.addButton(makeEntryButton(rows.get(i)));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makeEntryButton(final VoteLogMysqlTable.VoteLogEntry entry) {
+		Material mat = "CACHED".equalsIgnoreCase(entry.status) ? Material.CHEST : Material.EMERALD;
+
+		String timeStr = AdminVoteLogHelpers.formatTime(entry.voteTime);
+		String uuidShort = AdminVoteLogHelpers.shortUuid(entry.playerUuid);
+		String voteShort = AdminVoteLogHelpers.shortUuid(entry.voteId);
+
+		// keep same name/lore layout you already have
+		ItemBuilder item = new ItemBuilder(mat)
+				.setName("&a" + AdminVoteLogHelpers.safe(entry.event) + " &7(" + voteShort + ")");
+
+		if (AdminVoteLogHelpers.notEmpty(entry.playerName) || AdminVoteLogHelpers.notEmpty(entry.playerUuid)) {
+			item.addLoreLine("&7Player: &f" + AdminVoteLogHelpers.safe(entry.playerName) + " &7(" + uuidShort + ")");
+		}
+		if (entry.voteTime > 0) {
+			item.addLoreLine("&7Time: &f" + timeStr);
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.service)) {
+			item.addLoreLine("&7Service: &f" + AdminVoteLogHelpers.safe(entry.service));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.context)) {
+			item.addLoreLine("&7Context: &f" + AdminVoteLogHelpers.safe(entry.context));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.status)) {
+			item.addLoreLine("&7Status: &f" + AdminVoteLogHelpers.safe(entry.status));
+		}
+		if (entry.proxyCachedTotal != 0) {
+			item.addLoreLine("&7Cached Total: &f" + entry.proxyCachedTotal);
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.voteId)) {
+			item.addLoreLine("&7VoteId: &f" + AdminVoteLogHelpers.safe(entry.voteId));
+		}
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				// vote_id is now the correlation id entry.voteId
+				new AdminVoteLogVoteId(plugin, clickEvent.getPlayer(), table, entry.voteId, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogPlayerSelect.java

@@ -0,0 +1,155 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Bukkit;
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: Select an ONLINE player, then open AdminVoteLogPlayer.
+ */
+public class AdminVoteLogPlayerSelect extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int days;
+	private final int page;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogPlayerSelect.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogPlayerSelect(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		this.days = Math.max(0, days);
+		this.page = Math.max(0, page);
+
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Players";
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			List<Player> online = new ArrayList<>(Bukkit.getOnlinePlayers());
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(online.size(), start + PAGE_SIZE);
+
+			if (start >= online.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo players")
+						.addLoreLine("&7No online players on this page.").addLoreLine("&7Try going back a page.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					Player p = online.get(i);
+					inv.addButton(makePlayerButton(p));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makePlayerButton(final Player target) {
+		String name = target.getName();
+
+		ItemBuilder item = new ItemBuilder(Material.NAME_TAG).setName("&a" + name)
+				.addLoreLine("&7Click to open votelog for this player")
+				.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time");
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogPlayer(plugin, clickEvent.getPlayer(), table, name, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogPlayerSelectOnline.java

@@ -0,0 +1,151 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Bukkit;
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: Select an ONLINE player, then open AdminVoteLogPlayer.
+ */
+public class AdminVoteLogPlayerSelectOnline extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int days;
+	private final int page;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogPlayerSelectOnline.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogPlayerSelectOnline(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		this.days = days;
+		this.page = Math.max(0, page);
+
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Players";
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+					}
+				});
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			List<Player> online = new ArrayList<>(Bukkit.getOnlinePlayers());
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(online.size(), start + PAGE_SIZE);
+
+			if (start >= online.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo players")
+						.addLoreLine("&7No online players on this page.").addLoreLine("&7Try going back a page.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					Player p = online.get(i);
+					inv.addButton(makePlayerButton(p));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makePlayerButton(Player target) {
+		String name = target.getName();
+
+		ItemBuilder item = new ItemBuilder(Material.NAME_TAG).setName("&a" + name)
+				.addLoreLine("&7Click to open votelog for this player")
+				.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time");
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogPlayer(plugin, clickEvent.getPlayer(), table, name, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogRecent.java

@@ -0,0 +1,255 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: Recent VoteLog entries (paged).
+ *
+ * Now supports optional event filter + days window.
+ */
+public class AdminVoteLogRecent extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int page;
+
+	private final int days; // 0 = all time
+	private final VoteLogMysqlTable.VoteLogEvent event; // null = all events
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogRecent.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param page   the page number
+	 */
+	public AdminVoteLogRecent(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table, int page) {
+		this(plugin, sender, table, null, page, 0, null);
+	}
+
+	/**
+	 * Constructor for AdminVoteLogRecent with user.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param page   the page number
+	 */
+	public AdminVoteLogRecent(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int page) {
+		this(plugin, sender, table, user, page, 0, null);
+	}
+
+	/**
+	 * Constructor for AdminVoteLogRecent with full parameters.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param page   the page number
+	 * @param days   the number of days to filter
+	 * @param event  the event type to filter
+	 */
+	// NEW constructor used by Menu/EventSelect
+	public AdminVoteLogRecent(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int page, int days, VoteLogMysqlTable.VoteLogEvent event) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+		this.page = Math.max(0, page);
+		this.days = Math.max(0, days);
+		this.event = event;
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Recent";
+			if (event != null) {
+				title += " &7(" + event.name() + ")";
+			}
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			int needed = (page + 1) * PAGE_SIZE;
+
+			List<VoteLogMysqlTable.VoteLogEntry> rows;
+			if (event == null) {
+				rows = (days > 0) ? table.getRecentAll(days, needed) : table.getRecent(needed);
+			} else {
+				rows = table.getRecentByEvent(event, days, needed);
+			}
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(rows.size(), start + PAGE_SIZE);
+
+			if (start >= rows.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo entries")
+						.addLoreLine("&7No vote log entries on this page.").addLoreLine("&7Try going back a page.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					inv.addButton(makeEntryButton(rows.get(i)));
+				}
+			}
+
+			addEventSwitchButtons(inv);
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private void addEventSwitchButtons(BInventory inv) {
+		inv.getPageButtons().add(new BInventoryButton(new ItemBuilder(Material.LIME_DYE)
+				.setName("&aEvent: &fVOTE_RECEIVED").addLoreLine("&7Show recent vote received events")) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogRecent(plugin, clickEvent.getPlayer(), table, user, 0, days,
+						VoteLogMysqlTable.VoteLogEvent.VOTE_RECEIVED).open();
+			}
+		}.setSlot(3));
+
+		// More... (open selector)
+		inv.getPageButtons().add(new BInventoryButton(
+				new ItemBuilder(Material.BOOK).setName("&aEvent: &fMore...").addLoreLine("&7Pick any event filter")) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogEventSelect(plugin, clickEvent.getPlayer(), table, user, days).open();
+			}
+		}.setSlot(4));
+
+		// All events
+		inv.getPageButtons().add(new BInventoryButton(new ItemBuilder(Material.GRAY_DYE).setName("&aEvent: &fALL")
+				.addLoreLine("&7Show recent logs for all events")) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogRecent(plugin, clickEvent.getPlayer(), table, user, 0, days, null).open();
+			}
+		}.setSlot(5));
+	}
+
+	private BInventoryButton makeEntryButton(final VoteLogMysqlTable.VoteLogEntry entry) {
+		VoteLogMysqlTable.VoteLogEvent event = entry.event != null ? VoteLogMysqlTable.VoteLogEvent.valueOf(entry.event)
+				: null;
+
+		Material mat = AdminVoteLogHelpers.getMaterialForEvent(event, entry.status);
+
+		String eventColor = AdminVoteLogHelpers.getEventColor(event);
+
+		String timeStr = AdminVoteLogHelpers.formatTime(entry.voteTime);
+		String uuidShort = AdminVoteLogHelpers.shortUuid(entry.playerUuid);
+		String voteShort = AdminVoteLogHelpers.shortUuid(entry.voteId);
+
+		ItemBuilder item = new ItemBuilder(mat)
+				.setName(eventColor + AdminVoteLogHelpers.safe(entry.event) + " &7(" + voteShort + ")");
+
+		if (AdminVoteLogHelpers.notEmpty(entry.playerName) || AdminVoteLogHelpers.notEmpty(entry.playerUuid)) {
+			item.addLoreLine("&7Player: &f" + AdminVoteLogHelpers.safe(entry.playerName) + " &7(" + uuidShort + ")");
+		}
+		if (entry.voteTime > 0) {
+			item.addLoreLine("&7Time: &f" + timeStr);
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.service)) {
+			item.addLoreLine("&7Service: &f" + AdminVoteLogHelpers.safe(entry.service));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.context)) {
+			item.addLoreLine("&7Context: &f" + AdminVoteLogHelpers.safe(entry.context));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.status)) {
+			item.addLoreLine("&7Status: &f" + AdminVoteLogHelpers.safe(entry.status));
+		}
+		if (entry.proxyCachedTotal != 0) {
+			item.addLoreLine("&7Cached Total: &f" + entry.proxyCachedTotal);
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.voteId)) {
+			item.addLoreLine("&7VoteId: &f" + AdminVoteLogHelpers.safe(entry.voteId));
+		}
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogVoteId(plugin, clickEvent.getPlayer(), table, entry.voteId, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogServer.java

@@ -0,0 +1,204 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: VoteLog entries for a given server (paged).
+ *
+ * Uses VoteLogMysqlTable instance passed in from CommandLoader.
+ */
+public class AdminVoteLogServer extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+	private final int page;
+
+	private final String server;
+	private final int days;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogServer.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param server the server name
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogServer(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table, String server,
+			int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.server = server;
+		this.days = Math.max(0, days);
+		this.page = Math.max(0, page);
+
+		if (sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	/**
+	 * Constructor for AdminVoteLogServer with user.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param server the server name
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogServer(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, String server, int days, int page) {
+		this(plugin, sender, table, server, days, page);
+		this.user = user;
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			BInventory inv = new BInventory("&aVoteLog - Server &7(" + AdminVoteLogHelpers.safe(server) + ")");
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			int needed = (page + 1) * PAGE_SIZE;
+			List<VoteLogMysqlTable.VoteLogEntry> rows = table.getByServer(server, days, needed);
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(rows.size(), start + PAGE_SIZE);
+
+			if (start >= rows.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo entries")
+						.addLoreLine("&7No vote log entries on this page.").addLoreLine("&7Try going back a page.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					inv.addButton(makeEntryButton(rows.get(i)));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makeEntryButton(final VoteLogMysqlTable.VoteLogEntry entry) {
+		VoteLogMysqlTable.VoteLogEvent event = entry.event != null ? VoteLogMysqlTable.VoteLogEvent.valueOf(entry.event)
+				: null;
+
+		Material mat = AdminVoteLogHelpers.getMaterialForEvent(event, entry.status);
+		String eventColor = AdminVoteLogHelpers.getEventColor(event);
+
+		String timeStr = AdminVoteLogHelpers.formatTime(entry.voteTime);
+		String uuidShort = AdminVoteLogHelpers.shortUuid(entry.playerUuid);
+		String voteShort = AdminVoteLogHelpers.shortUuid(entry.voteId);
+
+		ItemBuilder item = new ItemBuilder(mat)
+				.setName(eventColor + AdminVoteLogHelpers.safe(entry.event) + " &7(" + voteShort + ")");
+
+		if (AdminVoteLogHelpers.notEmpty(entry.playerName) || AdminVoteLogHelpers.notEmpty(entry.playerUuid)) {
+			item.addLoreLine("&7Player: &f" + AdminVoteLogHelpers.safe(entry.playerName) + " &7(" + uuidShort + ")");
+		}
+		if (entry.voteTime > 0) {
+			item.addLoreLine("&7Time: &f" + timeStr);
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.server)) {
+			item.addLoreLine("&7Server: &f" + AdminVoteLogHelpers.safe(entry.server));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.service)) {
+			item.addLoreLine("&7Service: &f" + AdminVoteLogHelpers.safe(entry.service));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.context)) {
+			item.addLoreLine("&7Context: &f" + AdminVoteLogHelpers.safe(entry.context));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.status)) {
+			item.addLoreLine("&7Status: &f" + AdminVoteLogHelpers.safe(entry.status));
+		}
+		if (entry.proxyCachedTotal != 0) {
+			item.addLoreLine("&7Cached Total: &f" + entry.proxyCachedTotal);
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.voteId)) {
+			item.addLoreLine("&7VoteId: &f" + AdminVoteLogHelpers.safe(entry.voteId));
+		}
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				// vote_id is the correlation id
+				new AdminVoteLogVoteId(plugin, clickEvent.getPlayer(), table, entry.voteId, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogServerSelect.java

@@ -0,0 +1,152 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: Select a server (distinct list), then open AdminVoteLogServer.
+ */
+public class AdminVoteLogServerSelect extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int days;
+	private final int page;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogServerSelect.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogServerSelect(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		this.days = Math.max(0, days);
+		this.page = Math.max(0, page);
+
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Servers";
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			int needed = (page + 1) * PAGE_SIZE;
+			List<String> servers = table.getDistinctServers(days, needed);
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(servers.size(), start + PAGE_SIZE);
+
+			if (start >= servers.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo servers")
+						.addLoreLine("&7No servers on this page.").addLoreLine("&7Try going back a page.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					String srv = servers.get(i);
+					inv.addButton(makeServerButton(srv));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makeServerButton(final String server) {
+		ItemBuilder item = new ItemBuilder(Material.PAPER).setName("&a" + AdminVoteLogHelpers.safe(server))
+				.addLoreLine("&7Click to open votelog for this server")
+				.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time");
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogServer(plugin, clickEvent.getPlayer(), table, server, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogService.java

@@ -0,0 +1,204 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: VoteLog entries for a given service/site (paged).
+ *
+ * Uses VoteLogMysqlTable instance passed in from CommandLoader.
+ */
+public class AdminVoteLogService extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+	private final int page;
+
+	private final String service;
+	private final int days;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogService.
+	 *
+	 * @param plugin  the VotingPluginMain instance
+	 * @param sender  the command sender
+	 * @param table   the vote log table
+	 * @param service the service name
+	 * @param days    the number of days to filter
+	 * @param page    the page number
+	 */
+	public AdminVoteLogService(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table, String service,
+			int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.service = service;
+		this.days = days;
+		this.page = Math.max(0, page);
+
+		if (sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	/**
+	 * Constructor for AdminVoteLogService with user.
+	 *
+	 * @param plugin  the VotingPluginMain instance
+	 * @param sender  the command sender
+	 * @param table   the vote log table
+	 * @param user    the voting plugin user
+	 * @param service the service name
+	 * @param days    the number of days to filter
+	 * @param page    the page number
+	 */
+	public AdminVoteLogService(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, String service, int days, int page) {
+		this(plugin, sender, table, service, days, page);
+		this.user = user;
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			BInventory inv = new BInventory("&aVoteLog - Service &7(" + AdminVoteLogHelpers.safe(service) + ")");
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			int needed = (page + 1) * PAGE_SIZE;
+			List<VoteLogMysqlTable.VoteLogEntry> rows = table.getByService(service, days, needed);
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(rows.size(), start + PAGE_SIZE);
+
+			if (start >= rows.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo entries")
+						.addLoreLine("&7No vote log entries on this page.").addLoreLine("&7Try going back a page.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					inv.addButton(makeEntryButton(rows.get(i)));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makeEntryButton(final VoteLogMysqlTable.VoteLogEntry entry) {
+		VoteLogMysqlTable.VoteLogEvent event = entry.event != null ? VoteLogMysqlTable.VoteLogEvent.valueOf(entry.event)
+				: null;
+
+		Material mat = AdminVoteLogHelpers.getMaterialForEvent(event, entry.status);
+
+		String eventColor = AdminVoteLogHelpers.getEventColor(event);
+
+		String timeStr = AdminVoteLogHelpers.formatTime(entry.voteTime);
+		String uuidShort = AdminVoteLogHelpers.shortUuid(entry.playerUuid);
+		String voteShort = AdminVoteLogHelpers.shortUuid(entry.voteId);
+
+		ItemBuilder item = new ItemBuilder(mat)
+				.setName(eventColor + AdminVoteLogHelpers.safe(entry.event) + " &7(" + voteShort + ")");
+
+		if (AdminVoteLogHelpers.notEmpty(entry.playerName) || AdminVoteLogHelpers.notEmpty(entry.playerUuid)) {
+			item.addLoreLine("&7Player: &f" + AdminVoteLogHelpers.safe(entry.playerName) + " &7(" + uuidShort + ")");
+		}
+		if (entry.voteTime > 0) {
+			item.addLoreLine("&7Time: &f" + timeStr);
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.service)) {
+			item.addLoreLine("&7Service: &f" + AdminVoteLogHelpers.safe(entry.service));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.context)) {
+			item.addLoreLine("&7Context: &f" + AdminVoteLogHelpers.safe(entry.context));
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.status)) {
+			item.addLoreLine("&7Status: &f" + AdminVoteLogHelpers.safe(entry.status));
+		}
+		if (entry.proxyCachedTotal != 0) {
+			item.addLoreLine("&7Cached Total: &f" + entry.proxyCachedTotal);
+		}
+		if (AdminVoteLogHelpers.notEmpty(entry.voteId)) {
+			item.addLoreLine("&7VoteId: &f" + AdminVoteLogHelpers.safe(entry.voteId));
+		}
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				// vote_id is the correlation id
+				new AdminVoteLogVoteId(plugin, clickEvent.getPlayer(), table, entry.voteId, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogServiceSelect.java

@@ -0,0 +1,152 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: Select a service (distinct list), then open AdminVoteLogService.
+ */
+public class AdminVoteLogServiceSelect extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int days;
+	private final int page;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogServiceSelect.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogServiceSelect(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		this.days = Math.max(0, days);
+		this.page = Math.max(0, page);
+
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Services";
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			int needed = (page + 1) * PAGE_SIZE;
+			List<String> services = table.getDistinctServices(days, needed);
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(services.size(), start + PAGE_SIZE);
+
+			if (start >= services.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo services")
+						.addLoreLine("&7No services on this page.").addLoreLine("&7Try going back a page.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					String svc = services.get(i);
+					inv.addButton(makeServiceButton(svc));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makeServiceButton(final String service) {
+		ItemBuilder item = new ItemBuilder(Material.PAPER).setName("&a" + AdminVoteLogHelpers.safe(service))
+				.addLoreLine("&7Click to open votelog for this service")
+				.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time");
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogService(plugin, clickEvent.getPlayer(), table, service, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogServiceSelectAll.java

@@ -0,0 +1,150 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: Select a service from DB (distinct services), then open
+ * AdminVoteLogService.
+ */
+public class AdminVoteLogServiceSelectAll extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int days;
+	private final int page;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogServiceSelectAll.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogServiceSelectAll(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		this.days = days;
+		this.page = Math.max(0, page);
+
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Services";
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+					}
+				});
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			int needed = (page + 1) * PAGE_SIZE;
+			List<String> services = table.getDistinctServices(days, needed);
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(services.size(), start + PAGE_SIZE);
+
+			if (start >= services.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo services")
+						.addLoreLine("&7No services on this page.").addLoreLine("&7Try going back a page.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					String svc = services.get(i);
+					inv.addButton(makeServiceButton(svc));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makeServiceButton(String service) {
+		ItemBuilder item = new ItemBuilder(Material.PAPER).setName("&a" + AdminVoteLogHelpers.safe(service))
+				.addLoreLine("&7Click to open votelog for this service")
+				.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time");
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteLogService(plugin, clickEvent.getPlayer(), table, service, days, 0).open();
+			}
+		};
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogStats.java

@@ -0,0 +1,239 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.util.ArrayList;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: VoteLog stats overview.
+ *
+ * Uses VoteLogMysqlTable instance passed in from CommandLoader.
+ *
+ * Shows: - total / immediate / cached counts (VoteLogCounts) - unique voters -
+ * top services - top servers
+ */
+public class AdminVoteLogStats extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+
+	private final int days;
+
+	private final int topServicesLimit;
+	private final int topServersLimit;
+
+	/**
+	 * Constructor for AdminVoteLogStats.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param days   the number of days to filter
+	 */
+	public AdminVoteLogStats(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table, int days) {
+		this(plugin, sender, table, null, days, 10, 10);
+	}
+
+	/**
+	 * Constructor for AdminVoteLogStats with user and top services limit.
+	 *
+	 * @param plugin           the VotingPluginMain instance
+	 * @param sender           the command sender
+	 * @param table            the vote log table
+	 * @param user             the voting plugin user
+	 * @param days             the number of days to filter
+	 * @param topServicesLimit the maximum number of top services to display
+	 */
+	public AdminVoteLogStats(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days, int topServicesLimit) {
+		this(plugin, sender, table, user, days, topServicesLimit, 10);
+	}
+
+	/**
+	 * Constructor for AdminVoteLogStats with full parameters.
+	 *
+	 * @param plugin           the VotingPluginMain instance
+	 * @param sender           the command sender
+	 * @param table            the vote log table
+	 * @param user             the voting plugin user
+	 * @param days             the number of days to filter
+	 * @param topServicesLimit the maximum number of top services to display
+	 * @param topServersLimit  the maximum number of top servers to display
+	 */
+	public AdminVoteLogStats(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, int days, int topServicesLimit, int topServersLimit) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.user = user;
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+		this.days = Math.max(0, days);
+		this.topServicesLimit = topServicesLimit <= 0 ? 10 : topServicesLimit;
+		this.topServersLimit = topServersLimit <= 0 ? 10 : topServersLimit;
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - Stats";
+			if (days > 0) {
+				title += " &7(" + days + "d)";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			// counts
+			VoteLogMysqlTable.VoteLogCounts counts = table.getCounts(days);
+			long uniques = table.getUniqueVoters(days);
+
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.BOOK).setName("&aOverview")
+					.addLoreLine("&7Total Votes: &f" + counts.total).addLoreLine("&7Immediate: &f" + counts.immediate)
+					.addLoreLine("&7Cached: &f" + counts.cached).addLoreLine("&7Unique Voters: &f" + uniques)
+					.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time")) {
+
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					// no-op
+				}
+			});
+
+			// top services header
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.MAP).setName("&aTop Services")
+					.addLoreLine("&7Top " + topServicesLimit + " services/sites:")
+					.addLoreLine("&8(Click does nothing)")) {
+
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					// no-op
+				}
+			});
+
+			int shownServices = 0;
+			for (VoteLogMysqlTable.ServiceCount sc : table.getTopServices(days, topServicesLimit)) {
+				shownServices++;
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER)
+						.setName("&a#" + shownServices + " &f" + AdminVoteLogHelpers.safe(sc.service))
+						.addLoreLine("&7Votes: &f" + sc.votes)
+						.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op (could open AdminVoteLogService in future)
+					}
+				});
+			}
+
+			if (shownServices == 0) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo service data")
+						.addLoreLine("&7No services found in the log.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			}
+
+			// top servers header
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.COMPASS).setName("&aTop Servers")
+					.addLoreLine("&7Top " + topServersLimit + " servers:").addLoreLine("&8(Click does nothing)")) {
+
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					// no-op
+				}
+			});
+
+			int shownServers = 0;
+			for (VoteLogMysqlTable.ServerCount sc : table.getTopServers(days, topServersLimit)) {
+				shownServers++;
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER)
+						.setName("&a#" + shownServers + " &f" + AdminVoteLogHelpers.safe(sc.server))
+						.addLoreLine("&7Votes: &f" + sc.votes)
+						.addLoreLine(days > 0 ? "&7Window: &fLast " + days + " days" : "&7Window: &fAll time")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op (could open AdminVoteLogServer in future)
+					}
+				});
+			}
+
+			if (shownServers == 0) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo server data")
+						.addLoreLine("&7No servers found in the log.")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/votelog/AdminVoteLogVoteId.java

@@ -0,0 +1,257 @@
+package com.bencodez.votingplugin.commands.gui.admin.votelog;
+
+import java.text.SimpleDateFormat;
+import java.util.ArrayList;
+import java.util.Date;
+import java.util.List;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votelog.VoteLogMysqlTable;
+
+/**
+ * Admin GUI: VoteLog entries for a given voteId (paged).
+ *
+ * vote_id is NOT unique; this shows ALL rows for the correlation id.
+ */
+public class AdminVoteLogVoteId extends GUIHandler {
+
+	private final VotingPluginMain plugin;
+	private final VoteLogMysqlTable table;
+	private VotingPluginUser user;
+	private final int page;
+
+	private final String voteId;
+	private final int days;
+
+	private static final int PAGE_SIZE = 45;
+
+	/**
+	 * Constructor for AdminVoteLogVoteId.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param voteId the vote ID to filter
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogVoteId(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table, String voteId,
+			int days, int page) {
+		super(plugin, sender);
+		this.plugin = plugin;
+		this.table = table;
+		this.voteId = voteId;
+		this.days = days;
+		this.page = Math.max(0, page);
+
+		if (sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	/**
+	 * Constructor for AdminVoteLogVoteId with user.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param sender the command sender
+	 * @param table  the vote log table
+	 * @param user   the voting plugin user
+	 * @param voteId the vote ID to filter
+	 * @param days   the number of days to filter
+	 * @param page   the page number
+	 */
+	public AdminVoteLogVoteId(VotingPluginMain plugin, CommandSender sender, VoteLogMysqlTable table,
+			VotingPluginUser user, String voteId, int days, int page) {
+		this(plugin, sender, table, voteId, days, page);
+		this.user = user;
+		if (this.user == null && sender instanceof Player) {
+			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) sender);
+		}
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		try {
+			String title = "&aVoteLog - VoteId";
+			if (voteId != null && !voteId.isEmpty()) {
+				title += " &7(" + shortId(voteId) + ")";
+			}
+
+			BInventory inv = new BInventory(title);
+			inv.requirePermission("VotingPlugin.Commands.AdminVote.VoteLog");
+
+			if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
+				inv.dontClose();
+			}
+
+			if (table == null) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cVoteLog unavailable")
+						.addLoreLine("&7VoteLog MySQL table is not loaded/enabled.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			if (voteId == null || voteId.isEmpty()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo voteId provided")
+						.addLoreLine("&7Missing voteId.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+
+				inv.setPages(true);
+				inv.setMaxInvSize(54);
+				inv.openInventory(player);
+				return;
+			}
+
+			int needed = (page + 1) * PAGE_SIZE;
+
+			// vote_id is not unique -> show ALL rows for it (paged)
+			List<VoteLogMysqlTable.VoteLogEntry> rows = table.getByVoteIdAll(voteId, days, needed);
+
+			int start = page * PAGE_SIZE;
+			int end = Math.min(rows.size(), start + PAGE_SIZE);
+
+			if (start >= rows.size()) {
+				inv.addButton(new BInventoryButton(new ItemBuilder(Material.PAPER).setName("&eNo entries")
+						.addLoreLine("&7No vote log entries on this page.").addLoreLine("&7Try going back a page.")) {
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						// no-op
+					}
+				});
+			} else {
+				for (int i = start; i < end; i++) {
+					inv.addButton(makeEntryButton(rows.get(i)));
+				}
+			}
+
+			inv.setPages(true);
+			inv.setMaxInvSize(54);
+			inv.openInventory(player);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
+	}
+
+	private BInventoryButton makeEntryButton(VoteLogMysqlTable.VoteLogEntry entry) {
+		VoteLogMysqlTable.VoteLogEvent event = entry.event != null ? VoteLogMysqlTable.VoteLogEvent.valueOf(entry.event)
+				: null;
+
+		Material mat = AdminVoteLogHelpers.getMaterialForEvent(event, entry.status);
+
+		String eventColor = AdminVoteLogHelpers.getEventColor(event);
+
+		String timeStr = formatTime(entry.voteTime);
+		String uuidShort = shortId(entry.playerUuid);
+		String voteShort = shortId(entry.voteId);
+
+		ItemBuilder item = new ItemBuilder(mat)
+				.setName(eventColor + AdminVoteLogHelpers.safe(entry.event) + " &7(" + voteShort + ")");
+
+		// Only add lore lines when the value is actually set / meaningful
+		// (prevents blank/0/default noise)
+		if (notEmpty(entry.playerName) || notEmpty(entry.playerUuid)) {
+			item.addLoreLine("&7Player: &f" + safe(entry.playerName) + " &7(" + uuidShort + ")");
+		}
+
+		if (entry.voteTime > 0) {
+			item.addLoreLine("&7Time: &f" + timeStr);
+		}
+
+		if (notEmpty(entry.service)) {
+			item.addLoreLine("&7Service: &f" + safe(entry.service));
+		}
+
+		if (notEmpty(entry.context)) {
+			item.addLoreLine("&7Context: &f" + safe(entry.context));
+		}
+
+		if (notEmpty(entry.status)) {
+			item.addLoreLine("&7Status: &f" + safe(entry.status));
+		}
+
+		if (entry.proxyCachedTotal != 0) {
+			item.addLoreLine("&7Cached Total: &f" + entry.proxyCachedTotal);
+		}
+
+		if (notEmpty(entry.voteId)) {
+			item.addLoreLine("&7VoteId: &f" + safe(entry.voteId));
+		}
+
+		return new BInventoryButton(item) {
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				// read-only
+			}
+		};
+	}
+
+	private String formatTime(long millis) {
+		try {
+			SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
+			return sdf.format(new Date(millis));
+		} catch (Exception e) {
+			return String.valueOf(millis);
+		}
+	}
+
+	private boolean notEmpty(String s) {
+		return s != null && !s.trim().isEmpty();
+	}
+
+	private String shortId(String s) {
+		if (s == null || s.isEmpty()) {
+			return "unknown";
+		}
+		return s.length() > 8 ? s.substring(0, 8) : s;
+	}
+
+	private String safe(String s) {
+		return s == null ? "" : s;
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/voteshop/AdminVoteVoteShop.java

@@ -0,0 +1,186 @@
+package com.bencodez.votingplugin.commands.gui.admin.voteshop;
+
+import java.util.ArrayList;
+import java.util.Map;
+import java.util.Map.Entry;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.simpleapi.messages.MessageAPI;
+import com.bencodez.simpleapi.valuerequest.StringListener;
+import com.bencodez.simpleapi.valuerequest.ValueRequest;
+import com.bencodez.votingplugin.VotingPluginMain;
+
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Admin vote shop GUI handler.
+ */
+public class AdminVoteVoteShop extends GUIHandler {
+
+	@Getter
+	@Setter
+	private VotingPluginMain plugin;
+
+	/**
+	 * Constructor for AdminVoteVoteShop.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
+	public AdminVoteVoteShop(VotingPluginMain plugin, CommandSender player) {
+		super(plugin, player);
+		this.plugin = plugin;
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		BInventory inv = new BInventory("Edit VoteShop");
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteShop");
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.DIAMOND).setName("&cEdit existing item")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteShopItems(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.EMERALD_BLOCK).setName("&aAdd voteshop item")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new ValueRequest(plugin, plugin.getDialogService(), null).requestString(player, "", null, true,
+						"Enter item name", new StringListener() {
+
+							@Override
+							public void onInput(Player player, String value) {
+								plugin.getShopFile().createShop(value);
+								player.sendMessage(MessageAPI.colorize("&aShop item created successfully: " + value));
+								plugin.reload();
+							}
+						});
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.HOPPER).setName("&aAdd voteshop item from hand")
+				.addLoreLine("&7Hold an item in your main hand")
+				.addLoreLine("&7then click this button.")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				ItemStack item = getHeldItem(clickEvent);
+				if (isEmpty(item)) {
+					clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&cHold an item in your main hand first."));
+					new AdminVoteVoteShop(plugin, clickEvent.getPlayer()).open();
+					return;
+				}
+
+				new ValueRequest(plugin, plugin.getDialogService(), null).requestString(clickEvent.getPlayer(), "", null, true,
+						"Enter item name", new StringListener() {
+
+							@Override
+							public void onInput(Player player, String value) {
+								createShopFromItem(value, item);
+								player.sendMessage(MessageAPI.colorize("&aShop item created successfully: " + value));
+								plugin.reload();
+							}
+						});
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.CHEST).setName("&bEdit categories")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteShopCategories(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.REDSTONE_BLOCK).setName("&cRemove item")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteShopItemRemove(plugin, clickEvent.getPlayer()).open();
+			}
+		});
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+
+	/**
+	 * Creates a new shop item and copies the held item to display and rewards.
+	 *
+	 * @param identifier the shop identifier
+	 * @param itemStack  the item stack to copy
+	 */
+	private void createShopFromItem(String identifier, ItemStack itemStack) {
+		String basePath = "Shop." + identifier;
+		plugin.getShopFile().getData().set(basePath, null);
+		plugin.getShopFile().getData().set(basePath + ".Identifier_Name", identifier);
+		plugin.getShopFile().getData().set(basePath + ".Cost", 1);
+		plugin.getShopFile().getData().set(basePath + ".Permission", "");
+		plugin.getShopFile().getData().set(basePath + ".CloseGUI", true);
+		plugin.getShopFile().getData().set(basePath + ".RequireConfirmation", false);
+		ItemBuilder item = new ItemBuilder(itemStack.clone());
+		Map<String, Object> map = item.getConfiguration(true);
+		for (Entry<String, Object> entry : map.entrySet()) {
+			plugin.getShopFile().getData().set(basePath + ".DisplayItem.ItemStack." + entry.getKey(), entry.getValue());
+			plugin.getShopFile().getData().set(basePath + ".Rewards.Items.Item1.ItemStack." + entry.getKey(), entry.getValue());
+		}
+		plugin.getShopFile().saveData();
+	}
+
+	/**
+	 * Gets the item the player is holding in their main hand.
+	 *
+	 * @param clickEvent the click event
+	 * @return the held item
+	 */
+	private ItemStack getHeldItem(ClickEvent clickEvent) {
+		return clickEvent.getPlayer().getInventory().getItemInMainHand().clone();
+	}
+
+	/**
+	 * Checks if an item stack is empty.
+	 *
+	 * @param itemStack the item stack
+	 * @return true if empty
+	 */
+	private boolean isEmpty(ItemStack itemStack) {
+		return itemStack == null || itemStack.getType() == Material.AIR;
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/voteshop/AdminVoteVoteShopCategories.java

@@ -0,0 +1,229 @@
+package com.bencodez.votingplugin.commands.gui.admin.voteshop;
+
+import java.util.ArrayList;
+import java.util.Map;
+import java.util.Map.Entry;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.simpleapi.messages.MessageAPI;
+import com.bencodez.simpleapi.valuerequest.StringListener;
+import com.bencodez.simpleapi.valuerequest.ValueRequest;
+import com.bencodez.votingplugin.VotingPluginMain;
+
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Admin vote shop categories GUI handler.
+ */
+public class AdminVoteVoteShopCategories extends GUIHandler {
+
+	@Getter
+	@Setter
+	private VotingPluginMain plugin;
+
+	/**
+	 * Constructor for AdminVoteVoteShopCategories.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
+	public AdminVoteVoteShopCategories(VotingPluginMain plugin, CommandSender player) {
+		super(plugin, player);
+		this.plugin = plugin;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		BInventory inv = new BInventory("Edit VoteShop Categories");
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteShop");
+
+		ConfigurationSection categories = plugin.getShopFile().getCategoriesSection();
+		if (categories != null) {
+			for (String category : categories.getKeys(false)) {
+				ConfigurationSection categorySection = plugin.getShopFile().getCategorySection(category);
+				inv.addButton(new BInventoryButton(getCategoryItem(category, categorySection)) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						new AdminVoteVoteShopCategory(plugin, clickEvent.getPlayer(), (String) getData("category"))
+								.open(GUIMethod.CHEST);
+					}
+				}.addData("category", category));
+			}
+		}
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.EMERALD_BLOCK).setName("&aAdd category")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new ValueRequest(plugin, plugin.getDialogService(), null).requestString(clickEvent.getPlayer(), "", null, true,
+						"Enter category name", new StringListener() {
+
+							@Override
+							public void onInput(Player player, String value) {
+								createCategory(value, null);
+								player.sendMessage(MessageAPI.colorize("&aCategory created successfully: " + value));
+								plugin.reload();
+							}
+						});
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.HOPPER).setName("&aAdd category from hand")
+				.addLoreLine("&7Drag an item onto this button")
+				.addLoreLine("&7or click while holding an item.")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				ItemStack itemStack = getHeldItem(clickEvent);
+				if (isEmpty(itemStack)) {
+					clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&cHold an item in your main hand first."));
+					new AdminVoteVoteShopCategories(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
+					return;
+				}
+				new ValueRequest(plugin, plugin.getDialogService(), null).requestString(clickEvent.getPlayer(), "", null, true,
+						"Enter category name", new StringListener() {
+
+							@Override
+							public void onInput(Player player, String value) {
+								createCategory(value, itemStack);
+								player.sendMessage(MessageAPI.colorize("&aCategory created successfully: " + value));
+								plugin.reload();
+							}
+						});
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.REDSTONE_BLOCK).setName("&cRemove category")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteShopCategoryRemove(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cBack")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteShop(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+
+	/**
+	 * Creates a category and matching main shop category button.
+	 *
+	 * @param category  the category identifier
+	 * @param itemStack optional display item
+	 */
+	private void createCategory(String category, ItemStack itemStack) {
+		String categoryPath = "Categories." + category;
+		String buttonPath = "Shop." + category;
+		plugin.getShopFile().getData().set(categoryPath + ".Name", "&b" + category);
+		plugin.getShopFile().getData().set(categoryPath + ".BackButton", true);
+		plugin.getShopFile().getData().set(categoryPath + ".BackButtonItem.Material", "BARRIER");
+		plugin.getShopFile().getData().set(categoryPath + ".BackButtonItem.Amount", 1);
+		plugin.getShopFile().getData().set(categoryPath + ".BackButtonItem.Slot", -2);
+		plugin.getShopFile().getData().set(categoryPath + ".BackButtonItem.Name", "&cBack");
+
+		plugin.getShopFile().getData().set(buttonPath + ".Category", category);
+		plugin.getShopFile().getData().set(buttonPath + ".Permission", "");
+		plugin.getShopFile().getData().set(buttonPath + ".HideOnNoPermission", true);
+
+		if (isEmpty(itemStack)) {
+			plugin.getShopFile().getData().set(buttonPath + ".DisplayItem.Material", "CHEST");
+			plugin.getShopFile().getData().set(buttonPath + ".DisplayItem.Amount", 1);
+			plugin.getShopFile().getData().set(buttonPath + ".DisplayItem.Name", "&b" + category);
+		} else {
+			ItemBuilder item = new ItemBuilder(itemStack.clone());
+			Map<String, Object> map = item.getConfiguration(true);
+			for (Entry<String, Object> entry : map.entrySet()) {
+				plugin.getShopFile().getData().set(buttonPath + ".DisplayItem.ItemStack." + entry.getKey(), entry.getValue());
+			}
+		}
+
+		if (!plugin.getShopFile().getData().isConfigurationSection(categoryPath + ".Shop")) {
+			plugin.getShopFile().getData().createSection(categoryPath + ".Shop");
+		}
+		plugin.getShopFile().saveData();
+	}
+
+	/**
+	 * Gets a display item for a category.
+	 *
+	 * @param category the category identifier
+	 * @param section  the category section
+	 * @return the display item
+	 */
+	private ItemBuilder getCategoryItem(String category, ConfigurationSection section) {
+		ConfigurationSection buttonSection = plugin.getShopFile().getData().getConfigurationSection("Shop." + category);
+		if (buttonSection != null) {
+			ConfigurationSection displaySection = plugin.getShopFile().getDisplaySection(buttonSection);
+			if (displaySection != null) {
+				return new ItemBuilder(displaySection).addLoreLine("&7Click to edit category");
+			}
+		}
+		String name = section == null ? "&b" + category : section.getString("Name", "&b" + category);
+		return new ItemBuilder(Material.CHEST).setName(name).addLoreLine("&7Click to edit category");
+	}
+
+	/**
+	 * Gets the item the player is holding in their main hand.
+	 *
+	 * @param clickEvent the click event
+	 * @return the held item
+	 */
+	private ItemStack getHeldItem(ClickEvent clickEvent) {
+		return clickEvent.getPlayer().getInventory().getItemInMainHand().clone();
+	}
+
+	/**
+	 * Checks if an item stack is empty.
+	 *
+	 * @param itemStack the item stack
+	 * @return true if empty
+	 */
+	private boolean isEmpty(ItemStack itemStack) {
+		return itemStack == null || itemStack.getType() == Material.AIR;
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/voteshop/AdminVoteVoteShopCategory.java

@@ -0,0 +1,383 @@
+package com.bencodez.votingplugin.commands.gui.admin.voteshop;
+
+import java.util.ArrayList;
+import java.util.Map;
+import java.util.Map.Entry;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.inventory.editgui.EditGUI;
+import com.bencodez.advancedcore.api.inventory.editgui.EditGUIButton;
+import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueBoolean;
+import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueList;
+import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueNumber;
+import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueString;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.simpleapi.messages.MessageAPI;
+import com.bencodez.simpleapi.valuerequest.StringListener;
+import com.bencodez.simpleapi.valuerequest.ValueRequest;
+import com.bencodez.votingplugin.VotingPluginMain;
+
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Admin vote shop category GUI handler.
+ */
+public class AdminVoteVoteShopCategory extends GUIHandler {
+
+	@Getter
+	@Setter
+	private VotingPluginMain plugin;
+	@Getter
+	@Setter
+	private String category;
+
+	/**
+	 * Constructor for AdminVoteVoteShopCategory.
+	 *
+	 * @param plugin   the VotingPluginMain instance
+	 * @param player   the command sender
+	 * @param category the category identifier
+	 */
+	public AdminVoteVoteShopCategory(VotingPluginMain plugin, CommandSender player, String category) {
+		super(plugin, player);
+		this.plugin = plugin;
+		this.category = category;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		EditGUI inv = new EditGUI("Edit Category: " + category);
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteShop");
+
+		ConfigurationSection categorySection = getCategorySection();
+		ConfigurationSection backButton = getBackButtonSection();
+		ConfigurationSection buttonDisplay = getCategoryButtonDisplaySection();
+
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.PAPER, 1),
+				new EditGUIValueString("Name", categorySection.getString("Name", "&b" + category)) {
+
+					@Override
+					public void setValue(Player player, String name) {
+						setCategoryData(getKey(), name);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.BARRIER, 1),
+				new EditGUIValueBoolean("BackButton", categorySection.getBoolean("BackButton", true)) {
+
+					@Override
+					public void setValue(Player player, boolean value) {
+						setCategoryData(getKey(), value);
+					}
+				}));
+
+		inv.addButton(new EditGUIButton(new ItemBuilder(backButton.getString("Material", "BARRIER")),
+				new EditGUIValueString("BackButtonItem.Material", backButton.getString("Material", "BARRIER")) {
+
+					@Override
+					public void setValue(Player player, String name) {
+						setCategoryData(getKey(), name);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.PAPER, 1),
+				new EditGUIValueString("BackButtonItem.Name", backButton.getString("Name", "&cBack")) {
+
+					@Override
+					public void setValue(Player player, String name) {
+						setCategoryData(getKey(), name);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.BOOK, 1),
+				new EditGUIValueList("BackButtonItem.Lore", backButton.getStringList("Lore")) {
+
+					@Override
+					public void setValue(Player player, ArrayList<String> value) {
+						setCategoryData(getKey(), value);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.ITEM_FRAME, 1),
+				new EditGUIValueNumber("BackButtonItem.Slot", backButton.getInt("Slot", -2)) {
+
+					@Override
+					public void setValue(Player player, Number num) {
+						setCategoryData(getKey(), num.intValue());
+					}
+				}));
+
+		inv.addButton(new EditGUIButton(new ItemBuilder(buttonDisplay.getString("Material", "CHEST")),
+				new EditGUIValueString("CategoryButton.Material", buttonDisplay.getString("Material", "CHEST")) {
+
+					@Override
+					public void setValue(Player player, String name) {
+						setCategoryButtonDisplayData("Material", name);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.PAPER, 1),
+				new EditGUIValueString("CategoryButton.Name", buttonDisplay.getString("Name", "&b" + category)) {
+
+					@Override
+					public void setValue(Player player, String name) {
+						setCategoryButtonDisplayData("Name", name);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.BOOK, 1),
+				new EditGUIValueList("CategoryButton.Lore", buttonDisplay.getStringList("Lore")) {
+
+					@Override
+					public void setValue(Player player, ArrayList<String> value) {
+						setCategoryButtonDisplayData("Lore", value);
+					}
+				}));
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.HOPPER).setName("&aSet category button from hand")
+				.addLoreLine("&7Hold an item in your main hand")
+				.addLoreLine("&7then click this button.")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				ItemStack itemStack = getHeldItem(clickEvent);
+				if (isEmpty(itemStack)) {
+					clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&cHold an item in your main hand first."));
+					new AdminVoteVoteShopCategory(plugin, clickEvent.getPlayer(), category).open(GUIMethod.CHEST);
+					return;
+				}
+				setCategoryButtonItem(itemStack);
+				clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&aUpdated category button item for " + category));
+				new AdminVoteVoteShopCategory(plugin, clickEvent.getPlayer(), category).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.DIAMOND).setName("&cEdit category items")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteShopItems(plugin, clickEvent.getPlayer(), category).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.EMERALD_BLOCK).setName("&aAdd category item")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new ValueRequest(plugin, plugin.getDialogService(), null).requestString(clickEvent.getPlayer(), "", null, true,
+						"Enter item name", new StringListener() {
+
+							@Override
+							public void onInput(Player player, String value) {
+								createCategoryShopItem(value, null);
+								player.sendMessage(MessageAPI.colorize("&aCategory shop item created successfully: " + value));
+								plugin.reload();
+							}
+						});
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.HOPPER).setName("&aAdd category item from hand")
+				.addLoreLine("&7Hold an item in your main hand")
+				.addLoreLine("&7then click this button.")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				ItemStack itemStack = getHeldItem(clickEvent);
+				if (isEmpty(itemStack)) {
+					clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&cHold an item in your main hand first."));
+					new AdminVoteVoteShopCategory(plugin, clickEvent.getPlayer(), category).open(GUIMethod.CHEST);
+					return;
+				}
+				new ValueRequest(plugin, plugin.getDialogService(), null).requestString(clickEvent.getPlayer(), "", null, true,
+						"Enter item name", new StringListener() {
+
+							@Override
+							public void onInput(Player player, String value) {
+								createCategoryShopItem(value, itemStack);
+								player.sendMessage(MessageAPI.colorize("&aCategory shop item created successfully: " + value));
+								plugin.reload();
+							}
+						});
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.REDSTONE_BLOCK).setName("&cRemove category item")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteShopItemRemove(plugin, clickEvent.getPlayer(), category).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cBack to categories")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				new AdminVoteVoteShopCategories(plugin, clickEvent.getPlayer()).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+
+	/**
+	 * Creates a category shop item.
+	 *
+	 * @param identifier the item identifier
+	 * @param itemStack  optional display item
+	 */
+	private void createCategoryShopItem(String identifier, ItemStack itemStack) {
+		String basePath = "Categories." + category + ".Shop." + identifier;
+		plugin.getShopFile().getData().set(basePath + ".Identifier_Name", identifier);
+		plugin.getShopFile().getData().set(basePath + ".Cost", 1);
+		plugin.getShopFile().getData().set(basePath + ".Permission", "");
+		plugin.getShopFile().getData().set(basePath + ".HideOnNoPermission", true);
+		plugin.getShopFile().getData().set(basePath + ".CloseGUI", true);
+		plugin.getShopFile().getData().set(basePath + ".RequireConfirmation", false);
+		plugin.getShopFile().getData().set(basePath + ".Rewards.Items.Item1.Material", "STONE");
+		plugin.getShopFile().getData().set(basePath + ".Rewards.Items.Item1.Amount", 1);
+		if (isEmpty(itemStack)) {
+			plugin.getShopFile().getData().set(basePath + ".DisplayItem.Material", "STONE");
+			plugin.getShopFile().getData().set(basePath + ".DisplayItem.Amount", 1);
+			plugin.getShopFile().getData().set(basePath + ".DisplayItem.Name", "&cPlaceholder item");
+		} else {
+			ItemBuilder item = new ItemBuilder(itemStack.clone());
+			Map<String, Object> map = item.getConfiguration(true);
+			for (Entry<String, Object> entry : map.entrySet()) {
+				plugin.getShopFile().getData().set(basePath + ".DisplayItem.ItemStack." + entry.getKey(), entry.getValue());
+			}
+		}
+		plugin.getShopFile().saveData();
+	}
+
+	/**
+	 * Sets category data.
+	 *
+	 * @param path  the relative path
+	 * @param value the value
+	 */
+	private void setCategoryData(String path, Object value) {
+		plugin.getShopFile().getData().set("Categories." + category + "." + path, value);
+		plugin.getShopFile().saveData();
+		plugin.reload();
+	}
+
+	/**
+	 * Sets category button display data.
+	 *
+	 * @param path  the relative display path
+	 * @param value the value
+	 */
+	private void setCategoryButtonDisplayData(String path, Object value) {
+		plugin.getShopFile().getData().set("Shop." + category + ".DisplayItem." + path, value);
+		plugin.getShopFile().saveData();
+		plugin.reload();
+	}
+
+	/**
+	 * Sets the main shop category button item from an item stack.
+	 *
+	 * @param itemStack the item stack
+	 */
+	private void setCategoryButtonItem(ItemStack itemStack) {
+		ItemBuilder item = new ItemBuilder(itemStack.clone());
+		Map<String, Object> map = item.getConfiguration(true);
+		plugin.getShopFile().getData().set("Shop." + category + ".DisplayItem", null);
+		for (Entry<String, Object> entry : map.entrySet()) {
+			plugin.getShopFile().getData().set("Shop." + category + ".DisplayItem.ItemStack." + entry.getKey(), entry.getValue());
+		}
+		plugin.getShopFile().saveData();
+		plugin.reload();
+	}
+
+	/**
+	 * Gets the category section.
+	 *
+	 * @return the category section
+	 */
+	private ConfigurationSection getCategorySection() {
+		ConfigurationSection section = plugin.getShopFile().getCategorySection(category);
+		if (section == null) {
+			section = plugin.getShopFile().getData().createSection("Categories." + category);
+		}
+		return section;
+	}
+
+	/**
+	 * Gets the back button section.
+	 *
+	 * @return the back button section
+	 */
+	private ConfigurationSection getBackButtonSection() {
+		ConfigurationSection section = plugin.getShopFile().getData()
+				.getConfigurationSection("Categories." + category + ".BackButtonItem");
+		if (section == null) {
+			section = plugin.getShopFile().getData().createSection("Categories." + category + ".BackButtonItem");
+		}
+		return section;
+	}
+
+	/**
+	 * Gets the category button display section.
+	 *
+	 * @return the display section
+	 */
+	private ConfigurationSection getCategoryButtonDisplaySection() {
+		ConfigurationSection section = plugin.getShopFile().getData()
+				.getConfigurationSection("Shop." + category + ".DisplayItem");
+		if (section == null) {
+			section = plugin.getShopFile().getData().createSection("Shop." + category + ".DisplayItem");
+		}
+		return section;
+	}
+
+	/**
+	 * Gets the item the player is holding in their main hand.
+	 *
+	 * @param clickEvent the click event
+	 * @return the held item
+	 */
+	private ItemStack getHeldItem(ClickEvent clickEvent) {
+		return clickEvent.getPlayer().getInventory().getItemInMainHand().clone();
+	}
+
+	/**
+	 * Checks if an item stack is empty.
+	 *
+	 * @param itemStack the item stack
+	 * @return true if empty
+	 */
+	private boolean isEmpty(ItemStack itemStack) {
+		return itemStack == null || itemStack.getType() == Material.AIR;
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/voteshop/AdminVoteVoteShopCategoryRemove.java

@@ -0,0 +1,119 @@
+package com.bencodez.votingplugin.commands.gui.admin.voteshop;
+
+import java.util.ArrayList;
+
+import org.bukkit.command.CommandSender;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.commands.gui.admin.AdminVoteConfirmation;
+
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Admin vote shop category remove GUI handler.
+ */
+public class AdminVoteVoteShopCategoryRemove extends GUIHandler {
+
+	@Getter
+	@Setter
+	private VotingPluginMain plugin;
+
+	/**
+	 * Constructor for AdminVoteVoteShopCategoryRemove.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
+	public AdminVoteVoteShopCategoryRemove(VotingPluginMain plugin, CommandSender player) {
+		super(plugin, player);
+		this.plugin = plugin;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		BInventory inv = new BInventory("Remove VoteShop Category");
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteShop");
+
+		ConfigurationSection categories = plugin.getShopFile().getCategoriesSection();
+		if (categories != null) {
+			for (final String category : categories.getKeys(false)) {
+				inv.addButton(new BInventoryButton(getCategoryItem(category).addLoreLine("&c&lClick to remove")) {
+
+					@Override
+					public void onClick(ClickEvent clickEvent) {
+						new AdminVoteConfirmation(plugin, clickEvent.getPlayer(), "Remove category " + category + "?") {
+
+							@Override
+							public void onConfirm(Player p) {
+								plugin.getShopFile().getData().set("Categories." + category, null);
+								plugin.getShopFile().getData().set("Shop." + category, null);
+								plugin.getShopFile().saveData();
+								p.sendMessage("Removed category " + category);
+								plugin.reload();
+							}
+
+							@Override
+							public void onDeny(Player p) {
+								new AdminVoteVoteShopCategories(plugin, p).open();
+							}
+						}.open();
+					}
+				});
+			}
+		}
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+
+	/**
+	 * Gets a category display item.
+	 *
+	 * @param category the category identifier
+	 * @return the display item
+	 */
+	private ItemBuilder getCategoryItem(String category) {
+		ConfigurationSection buttonSection = plugin.getShopFile().getData().getConfigurationSection("Shop." + category);
+		if (buttonSection != null) {
+			ConfigurationSection displaySection = plugin.getShopFile().getDisplaySection(buttonSection);
+			if (displaySection != null) {
+				return new ItemBuilder(displaySection);
+			}
+		}
+		ConfigurationSection categorySection = plugin.getShopFile().getCategorySection(category);
+		String name = categorySection == null ? "&b" + category : categorySection.getString("Name", "&b" + category);
+		return new ItemBuilder(org.bukkit.Material.CHEST).setName(name);
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/voteshop/AdminVoteVoteShopItem.java

@@ -0,0 +1,319 @@
+package com.bencodez.votingplugin.commands.gui.admin.voteshop;
+
+import java.util.ArrayList;
+import java.util.Map;
+import java.util.Map.Entry;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.inventory.editgui.EditGUI;
+import com.bencodez.advancedcore.api.inventory.editgui.EditGUIButton;
+import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueList;
+import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueNumber;
+import com.bencodez.advancedcore.api.inventory.editgui.valuetypes.EditGUIValueString;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.advancedcore.command.gui.RewardEditGUI;
+import com.bencodez.simpleapi.messages.MessageAPI;
+import com.bencodez.votingplugin.VotingPluginMain;
+
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Admin vote shop item GUI handler.
+ */
+public class AdminVoteVoteShopItem extends GUIHandler {
+
+	@Getter
+	@Setter
+	private String identifier;
+	@Getter
+	@Setter
+	private VotingPluginMain plugin;
+	@Getter
+	@Setter
+	private String category;
+
+	/**
+	 * Constructor for AdminVoteVoteShopItem.
+	 *
+	 * @param plugin     the VotingPluginMain instance
+	 * @param player     the command sender
+	 * @param identifier the item identifier
+	 */
+	public AdminVoteVoteShopItem(VotingPluginMain plugin, CommandSender player, String identifier) {
+		this(plugin, player, identifier, null);
+	}
+
+	/**
+	 * Constructor for AdminVoteVoteShopItem.
+	 *
+	 * @param plugin     the VotingPluginMain instance
+	 * @param player     the command sender
+	 * @param identifier the item identifier
+	 * @param category   the category identifier
+	 */
+	public AdminVoteVoteShopItem(VotingPluginMain plugin, CommandSender player, String identifier, String category) {
+		super(plugin, player);
+		this.plugin = plugin;
+		this.identifier = identifier;
+		this.category = category;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		EditGUI inv = new EditGUI("Edit VoteShop Item: " + identifier);
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteShop");
+
+		ConfigurationSection shopItemData = getShopItemSection();
+		ConfigurationSection displayItemData = plugin.getShopFile().getDisplaySection(shopItemData);
+		if (displayItemData == null) {
+			displayItemData = shopItemData;
+		}
+
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.PAPER, 1), new EditGUIValueString("Identifier_Name",
+				shopItemData.getString("Identifier_Name", identifier)) {
+
+			@Override
+			public void setValue(Player player, String name) {
+				setPathData(getKey(), name);
+			}
+		}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.OAK_DOOR, 1),
+				new EditGUIValueString("Permission", shopItemData.getString("Permission", "")) {
+
+					@Override
+					public void setValue(Player player, String name) {
+						setPathData(getKey(), name);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.EMERALD, 1),
+				new EditGUIValueNumber("Cost", shopItemData.getInt("Cost")) {
+
+					@Override
+					public void setValue(Player player, Number num) {
+						setPathData(getKey(), num.intValue());
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.BARRIER, 1),
+				new EditGUIValueNumber("Limit", shopItemData.getInt("Limit", -1)) {
+
+					@Override
+					public void setValue(Player player, Number num) {
+						setPathData(getKey(), num.intValue());
+					}
+				}));
+
+		inv.addButton(new EditGUIButton(new ItemBuilder(displayItemData.getString("Material", "STONE")).setAmount(1),
+				new EditGUIValueString(getDisplayPath("Material"), displayItemData.getString("Material", "STONE")) {
+
+					@Override
+					public void setValue(Player player, String name) {
+						setPathData(getKey(), name);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.PAPER, 1),
+				new EditGUIValueString(getDisplayPath("Name"), displayItemData.getString("Name", "")) {
+
+					@Override
+					public void setValue(Player player, String name) {
+						setPathData(getKey(), name);
+					}
+				}));
+		inv.addButton(new EditGUIButton(new ItemBuilder(Material.BOOK, 1),
+				new EditGUIValueList(getDisplayPath("Lore"), displayItemData.getStringList("Lore")) {
+
+					@Override
+					public void setValue(Player player, ArrayList<String> value) {
+						setPathData(getKey(), value);
+					}
+				}));
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(getPreviewItem(player)).addLoreLine("&cClick to copy held item display data")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				ItemStack itemStack = getHeldItem(clickEvent);
+				if (isEmpty(itemStack)) {
+					clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&cHold an item in your main hand first."));
+					new AdminVoteVoteShopItem(plugin, clickEvent.getPlayer(), identifier, category).open(GUIMethod.CHEST);
+					return;
+				}
+				setDisplayItemData(itemStack);
+				clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&aUpdated display item data for " + identifier));
+				new AdminVoteVoteShopItem(plugin, clickEvent.getPlayer(), identifier, category).open(GUIMethod.CHEST);
+			}
+		});
+		inv.addButton(new BInventoryButton(new ItemBuilder(getPreviewItem(player)).addLoreLine("&cClick to copy held exact item data")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				ItemStack itemStack = getHeldItem(clickEvent);
+				if (isEmpty(itemStack)) {
+					clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&cHold an item in your main hand first."));
+					new AdminVoteVoteShopItem(plugin, clickEvent.getPlayer(), identifier, category).open(GUIMethod.CHEST);
+					return;
+				}
+				setItemData(itemStack, true);
+				clickEvent.getPlayer().sendMessage(MessageAPI.colorize("&aUpdated exact ItemStack data for " + identifier));
+				new AdminVoteVoteShopItem(plugin, clickEvent.getPlayer(), identifier, category).open(GUIMethod.CHEST);
+			}
+		});
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(Material.DISPENSER, 1).setName("&cRewards")) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				RewardEditGUI.getInstance().openRewardGUI(clickEvent.getPlayer(),
+						plugin.getRewardHandler().getDirectlyDefined(getBasePath() + ".Rewards"));
+			}
+		});
+
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+
+	/**
+	 * Sets DisplayItem data using exact ItemStack serialization.
+	 *
+	 * @param itemStack the item stack to copy
+	 */
+	private void setDisplayItemData(ItemStack itemStack) {
+		ItemBuilder item = new ItemBuilder(itemStack.clone());
+		Map<String, Object> map = item.getConfiguration(true);
+		plugin.getShopFile().getData().set(getBasePath() + ".DisplayItem", null);
+		for (Entry<String, Object> entry : map.entrySet()) {
+			setPathData("DisplayItem.ItemStack." + entry.getKey(), entry.getValue());
+		}
+	}
+
+	/**
+	 * Sets item display or exact ItemStack data.
+	 *
+	 * @param itemStack the item stack to copy
+	 * @param exactData true to copy exact ItemStack data
+	 */
+	private void setItemData(ItemStack itemStack, boolean exactData) {
+		ItemBuilder item = new ItemBuilder(itemStack.clone());
+		Map<String, Object> map = item.getConfiguration(exactData);
+		for (Entry<String, Object> entry : map.entrySet()) {
+			setPathData(exactData ? "ItemStack." + entry.getKey() : getDisplayPath(entry.getKey()), entry.getValue());
+		}
+	}
+
+	/**
+	 * Sets data for the current shop item.
+	 *
+	 * @param path  the relative path
+	 * @param value the value
+	 */
+	private void setPathData(String path, Object value) {
+		plugin.getShopFile().getData().set(getBasePath() + "." + path, value);
+		plugin.getShopFile().saveData();
+		plugin.reload();
+	}
+
+	/**
+	 * Gets the base config path for this item.
+	 *
+	 * @return the config path
+	 */
+	private String getBasePath() {
+		if (category != null && !category.isEmpty()) {
+			return "Categories." + category + ".Shop." + identifier;
+		}
+		return "Shop." + identifier;
+	}
+
+	/**
+	 * Gets the current shop item section.
+	 *
+	 * @return the shop item section
+	 */
+	private ConfigurationSection getShopItemSection() {
+		ConfigurationSection section = plugin.getShopFile().getData().getConfigurationSection(getBasePath());
+		if (section == null) {
+			section = plugin.getShopFile().getData().createSection(getBasePath());
+		}
+		return section;
+	}
+
+	/**
+	 * Gets the display path for this item.
+	 *
+	 * @param path the display child path
+	 * @return the relative display path
+	 */
+	private String getDisplayPath(String path) {
+		if (getShopItemSection().isConfigurationSection("DisplayItem")) {
+			return "DisplayItem." + path;
+		}
+		return path;
+	}
+
+	/**
+	 * Gets a preview item for the current player.
+	 *
+	 * @param player the player
+	 * @return the preview item
+	 */
+	private ItemStack getPreviewItem(Player player) {
+		ItemStack itemStack = player.getInventory().getItemInMainHand();
+		if (isEmpty(itemStack)) {
+			return new ItemStack(Material.HOPPER);
+		}
+		return itemStack.clone();
+	}
+
+	/**
+	 * Gets the item the player is holding in their main hand.
+	 *
+	 * @param clickEvent the click event
+	 * @return the held item
+	 */
+	private ItemStack getHeldItem(ClickEvent clickEvent) {
+		return clickEvent.getPlayer().getInventory().getItemInMainHand().clone();
+	}
+
+	/**
+	 * Checks if an item stack is empty.
+	 *
+	 * @param itemStack the item stack
+	 * @return true if empty
+	 */
+	private boolean isEmpty(ItemStack itemStack) {
+		return itemStack == null || itemStack.getType() == Material.AIR;
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/voteshop/AdminVoteVoteShopItemRemove.java

@@ -0,0 +1,174 @@
+package com.bencodez.votingplugin.commands.gui.admin.voteshop;
+
+import java.util.ArrayList;
+import java.util.Set;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.commands.gui.admin.AdminVoteConfirmation;
+
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Admin vote shop item remove GUI handler.
+ */
+public class AdminVoteVoteShopItemRemove extends GUIHandler {
+
+	@Getter
+	@Setter
+	private VotingPluginMain plugin;
+	@Getter
+	@Setter
+	private String category;
+
+	/**
+	 * Constructor for AdminVoteVoteShopItemRemove.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
+	public AdminVoteVoteShopItemRemove(VotingPluginMain plugin, CommandSender player) {
+		this(plugin, player, null);
+	}
+
+	/**
+	 * Constructor for AdminVoteVoteShopItemRemove.
+	 *
+	 * @param plugin   the VotingPluginMain instance
+	 * @param player   the command sender
+	 * @param category the category identifier
+	 */
+	public AdminVoteVoteShopItemRemove(VotingPluginMain plugin, CommandSender player, String category) {
+		super(plugin, player);
+		this.plugin = plugin;
+		this.category = category;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		BInventory inv = new BInventory(category == null ? "Edit VoteShop Remove Item" : "Remove Category Item: " + category);
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteShop");
+
+		for (final String identifier : getIdentifiers()) {
+			ConfigurationSection section = getItemSection(identifier);
+			if (section == null) {
+				continue;
+			}
+			inv.addButton(new BInventoryButton(new ItemBuilder(plugin.getShopFile().getDisplaySection(section))
+					.addLoreLine("&c&lClick to remove")) {
+
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteConfirmation(plugin, clickEvent.getPlayer(), "Remove shop item " + identifier + "?") {
+
+						@Override
+						public void onConfirm(Player p) {
+							removeShop(identifier);
+							p.sendMessage("Removed " + identifier);
+							plugin.reload();
+						}
+
+						@Override
+						public void onDeny(Player p) {
+							if (category == null) {
+								new AdminVoteVoteShop(plugin, p).open();
+							} else {
+								new AdminVoteVoteShopCategory(plugin, p, category).open();
+							}
+						}
+					}.open();
+
+				}
+			}.addData("ident", identifier));
+		}
+		if (category != null) {
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cBack to category")) {
+
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteVoteShopCategory(plugin, clickEvent.getPlayer(), category).open(GUIMethod.CHEST);
+				}
+			});
+		}
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+
+	/**
+	 * Gets the identifiers to display.
+	 *
+	 * @return the identifiers
+	 */
+	private Set<String> getIdentifiers() {
+		if (category != null) {
+			ConfigurationSection section = plugin.getShopFile().getCategoryShopSection(category);
+			if (section != null) {
+				return section.getKeys(false);
+			}
+			return Set.of();
+		}
+		return plugin.getShopFile().getShopIdentifiers();
+	}
+
+	/**
+	 * Gets the item section.
+	 *
+	 * @param identifier the item identifier
+	 * @return the item section
+	 */
+	private ConfigurationSection getItemSection(String identifier) {
+		if (category != null) {
+			return plugin.getShopFile().getData().getConfigurationSection("Categories." + category + ".Shop." + identifier);
+		}
+		return plugin.getShopFile().getShopIdentifierSection(identifier);
+	}
+
+	/**
+	 * Removes a shop item.
+	 *
+	 * @param identifier the identifier
+	 */
+	private void removeShop(String identifier) {
+		if (category == null) {
+			plugin.getShopFile().removeShop(identifier);
+			return;
+		}
+		plugin.getShopFile().getData().set("Categories." + category + ".Shop." + identifier, null);
+		plugin.getShopFile().saveData();
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/admin/voteshop/AdminVoteVoteShopItems.java

@@ -0,0 +1,144 @@
+package com.bencodez.votingplugin.commands.gui.admin.voteshop;
+
+import java.util.ArrayList;
+import java.util.Set;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.votingplugin.VotingPluginMain;
+
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * Admin vote shop items GUI handler.
+ */
+public class AdminVoteVoteShopItems extends GUIHandler {
+
+	@Getter
+	@Setter
+	private VotingPluginMain plugin;
+	@Getter
+	@Setter
+	private String category;
+
+	/**
+	 * Constructor for AdminVoteVoteShopItems.
+	 *
+	 * @param plugin the VotingPluginMain instance
+	 * @param player the command sender
+	 */
+	public AdminVoteVoteShopItems(VotingPluginMain plugin, CommandSender player) {
+		this(plugin, player, null);
+	}
+
+	/**
+	 * Constructor for AdminVoteVoteShopItems.
+	 *
+	 * @param plugin   the VotingPluginMain instance
+	 * @param player   the command sender
+	 * @param category the category identifier
+	 */
+	public AdminVoteVoteShopItems(VotingPluginMain plugin, CommandSender player, String category) {
+		super(plugin, player);
+		this.plugin = plugin;
+		this.category = category;
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		BInventory inv = new BInventory(category == null ? "Edit VoteShop Items" : "Edit Category Items: " + category);
+		inv.requirePermission("VotingPlugin.Commands.AdminVote.Edit.VoteShop");
+
+		for (String identifier : getIdentifiers()) {
+			ConfigurationSection section = getItemSection(identifier);
+			if (section == null) {
+				continue;
+			}
+			inv.addButton(new BInventoryButton(new ItemBuilder(plugin.getShopFile().getDisplaySection(section))) {
+
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteVoteShopItem(plugin, clickEvent.getPlayer(), (String) getData("ident"), category)
+							.open(GUIMethod.CHEST);
+
+				}
+			}.addData("ident", identifier));
+		}
+
+		if (category != null) {
+			inv.addButton(new BInventoryButton(new ItemBuilder(Material.BARRIER).setName("&cBack to category")) {
+
+				@Override
+				public void onClick(ClickEvent clickEvent) {
+					new AdminVoteVoteShopCategory(plugin, clickEvent.getPlayer(), category).open(GUIMethod.CHEST);
+				}
+			});
+		}
+
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+
+	/**
+	 * Gets the identifiers to display.
+	 *
+	 * @return the identifiers
+	 */
+	private Set<String> getIdentifiers() {
+		if (category != null) {
+			ConfigurationSection section = plugin.getShopFile().getCategoryShopSection(category);
+			if (section != null) {
+				return section.getKeys(false);
+			}
+			return Set.of();
+		}
+		return plugin.getShopFile().getShopIdentifiers();
+	}
+
+	/**
+	 * Gets the item section.
+	 *
+	 * @param identifier the item identifier
+	 * @return the item section
+	 */
+	private ConfigurationSection getItemSection(String identifier) {
+		if (category != null) {
+			return plugin.getShopFile().getData().getConfigurationSection("Categories." + category + ".Shop." + identifier);
+		}
+		return plugin.getShopFile().getShopIdentifierSection(identifier);
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteBest.java

@@ -18,11 +18,21 @@ import com.bencodez.simpleapi.array.ArrayUtils;
 import com.bencodez.votingplugin.VotingPluginMain;
 import com.bencodez.votingplugin.user.VotingPluginUser;
 
+/**
+ * GUI handler for vote best/streak display.
+ */
 public class VoteBest extends GUIHandler {
 
 	private VotingPluginMain plugin;
 	private VotingPluginUser user;
 
+	/**
+	 * Constructs a new vote best GUI.
+	 * 
+	 * @param plugin the plugin instance
+	 * @param player the command sender
+	 * @param user   the voting plugin user
+	 */
 	public VoteBest(VotingPluginMain plugin, CommandSender player, VotingPluginUser user) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -47,6 +57,41 @@ public class VoteBest extends GUIHandler {
 		return ArrayUtils.colorize(msg);
 	}
 
+	@Override
+	public void onDialog(Player player) {
+		plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName())
+				.placeholder("HighestDailyTotal", "" + user.getHighestDailyTotal())
+				.placeholder("HighestWeeklyTotal", "" + user.getHighestWeeklyTotal())
+				.placeholder("HighestMonthlyTotal", "" + user.getHighestMonthlyTotal())
+				.title(plugin.getGui().getChestVoteBestName())
+				.body(plugin.getConfigFile().getFormatCommandsVoteBestTitle())
+				.columns(2)
+				.button(plugin.getGui().getChestVoteBestDayBestItem().getName(),
+						"&7Best daily total: &e%HighestDailyTotal%",
+						payload -> {
+						})
+				.button(plugin.getGui().getChestVoteBestWeekBestItem().getName(),
+						"&7Best weekly total: &e%HighestWeeklyTotal%",
+						payload -> {
+						})
+				.button(plugin.getGui().getChestVoteBestMonthBestItem().getName(),
+						"&7Best monthly total: &e%HighestMonthlyTotal%",
+						payload -> {
+						})
+				.button(plugin.getGui().isChestVoteBestBackButton() ? "&eBack" : "",
+						plugin.getGui().isChestVoteBestBackButton() ? "&7Return to previous menu" : "",
+						payload -> {
+							if (plugin.getGui().isChestVoteBestBackButton()) {
+								Player clicked = player.getServer().getPlayer(payload.owner());
+								if (clicked != null) {
+									new VoteGUI(plugin, clicked, user).open();
+								}
+							}
+						})
+				.open();
+	}
+
 	@Override
 	public void onBook(Player player) {
 		// TODO

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteGUI.java

@@ -19,11 +19,21 @@ import com.bencodez.simpleapi.messages.MessageAPI;
 import com.bencodez.votingplugin.VotingPluginMain;
 import com.bencodez.votingplugin.user.VotingPluginUser;
 
+/**
+ * GUI handler for vote interface.
+ */
 public class VoteGUI extends GUIHandler {
 
 	private VotingPluginMain plugin;
 	private VotingPluginUser user;
 
+	/**
+	 * Constructs a new vote GUI.
+	 * 
+	 * @param plugin the plugin instance
+	 * @param player the command sender
+	 * @param user   the voting plugin user
+	 */
 	public VoteGUI(VotingPluginMain plugin, CommandSender player, VotingPluginUser user) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -35,6 +45,58 @@ public class VoteGUI extends GUIHandler {
 		return null;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+		if (this.user == null) {
+			user = plugin.getVotingPluginUserManager().getVotingPluginUser(player);
+		}
+
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("points", "" + user.getPoints()).placeholder("player", user.getPlayerName())
+				.placeholder("top", plugin.getConfigFile().getVoteTopDefault())
+				.placeholder("sitesavailable", "" + user.getSitesNotVotedOn())
+				.title(plugin.getGui().getChestVoteGUIName()).body("&7Select an option").columns(2);
+
+		for (final String slot : plugin.getGui().getChestVoteGUISlots()) {
+			ItemBuilder builder = getItemSlot(slot, player);
+
+			String buttonText = builder.getName();
+			String tooltip = "";
+
+			if (builder.getLore() != null && !builder.getLore().isEmpty()) {
+				tooltip = builder.getLore().get(0);
+			}
+
+			dialog.button(buttonText, tooltip, payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked == null) {
+					return;
+				}
+
+				String cmd = plugin.getGui().getChestVoteGUISlotCommand(slot);
+
+				if (cmd.equalsIgnoreCase("none")) {
+					return;
+				}
+
+				if (!cmd.equals("")) {
+					clicked.performCommand(cmd);
+				} else {
+					plugin.getCommandLoader().processSlotClick(clicked, user, slot);
+				}
+			});
+		}
+
+		dialog.open();
+	}
+
+	/**
+	 * Gets the item for a specific GUI slot.
+	 * 
+	 * @param slot   the slot name
+	 * @param player the player
+	 * @return the item builder for the slot
+	 */
 	private ItemBuilder getItemSlot(String slot, Player player) {
 		ItemBuilder builder = new ItemBuilder(plugin.getGui().getChestVoteGUISlotSection(slot));
 
@@ -207,6 +269,7 @@ public class VoteGUI extends GUIHandler {
 									.setGiveOffline(false).send(clickEvent.getPlayer());
 
 						}
+
 					});
 		}
 

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteHelp.java

@@ -11,17 +11,26 @@ import com.bencodez.advancedcore.api.command.CommandHandler;
 import com.bencodez.advancedcore.api.gui.GUIHandler;
 import com.bencodez.advancedcore.api.gui.GUIMethod;
 import com.bencodez.simpleapi.messages.MessageAPI;
-import com.bencodez.simpleapi.nms.NMSManager;
 import com.bencodez.votingplugin.VotingPluginMain;
 
 import net.md_5.bungee.api.ChatColor;
 import net.md_5.bungee.api.chat.TextComponent;
 
+/**
+ * GUI handler for vote help display.
+ */
 public class VoteHelp extends GUIHandler {
 
 	private int page;
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructs a new vote help GUI.
+	 * 
+	 * @param plugin the plugin instance
+	 * @param player the command sender
+	 * @param page   the page number
+	 */
 	public VoteHelp(VotingPluginMain plugin, CommandSender player, int page) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -33,6 +42,17 @@ public class VoteHelp extends GUIHandler {
 		return null;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	/**
+	 * Generates help text with hover support.
+	 * 
+	 * @param sender the command sender
+	 * @return list of text components for help
+	 */
 	public ArrayList<TextComponent> helpText(CommandSender sender) {
 		ArrayList<TextComponent> msg = new ArrayList<>();
 		HashMap<String, TextComponent> unsorted = new HashMap<>();
@@ -64,6 +84,12 @@ public class VoteHelp extends GUIHandler {
 		return msg;
 	}
 
+	/**
+	 * Generates legacy help text without hover support.
+	 * 
+	 * @param sender the command sender
+	 * @return list of text components for help
+	 */
 	public ArrayList<TextComponent> helpTextLegacy(CommandSender sender) {
 		ArrayList<TextComponent> msg = new ArrayList<>();
 		HashMap<String, TextComponent> unsorted = new HashMap<>();
@@ -106,15 +132,17 @@ public class VoteHelp extends GUIHandler {
 		open(GUIMethod.CHAT);
 	}
 
+	/**
+	 * Generates vote help text with pagination.
+	 * 
+	 * @param sender the command sender
+	 * @return list of text components for help
+	 */
 	public ArrayList<TextComponent> voteHelpText(CommandSender sender) {
 		int pagesize = plugin.getConfigFile().getFormatPageSize();
 		ArrayList<TextComponent> msg = new ArrayList<>();
 		ArrayList<TextComponent> text = new ArrayList<>();
-		if (NMSManager.getInstance().isVersion("1.12")) {
-			text = helpTextLegacy(sender);
-		} else {
-			text = helpText(sender);
-		}
+		text = helpText(sender);
 
 		int maxPage = text.size() / pagesize;
 		if ((text.size() % pagesize) != 0) {

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteLast.java

@@ -1,6 +1,7 @@
 package com.bencodez.votingplugin.commands.gui.player;
 
 import java.util.ArrayList;
+import java.util.HashMap;
 
 import org.bukkit.command.CommandSender;
 import org.bukkit.entity.Player;
@@ -17,14 +18,24 @@ import com.bencodez.advancedcore.api.rewards.RewardBuilder;
 import com.bencodez.simpleapi.array.ArrayUtils;
 import com.bencodez.simpleapi.messages.MessageAPI;
 import com.bencodez.votingplugin.VotingPluginMain;
-import com.bencodez.votingplugin.objects.VoteSite;
 import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
+/**
+ * GUI handler for displaying last vote information.
+ */
 public class VoteLast extends GUIHandler {
 
 	private VotingPluginMain plugin;
 	private VotingPluginUser user;
 
+	/**
+	 * Constructs a new VoteLast GUI handler.
+	 *
+	 * @param plugin the main plugin instance
+	 * @param player the command sender
+	 * @param user   the voting plugin user
+	 */
 	public VoteLast(VotingPluginMain plugin, CommandSender player, VotingPluginUser user) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -40,7 +51,7 @@ public class VoteLast extends GUIHandler {
 		msg.add(MessageAPI.replaceIgnoreCase(plugin.getConfigFile().getFormatCommandsVoteLastTitle(), "%player%",
 				playerName));
 
-		for (VoteSite voteSite : plugin.getVoteSitesEnabled()) {
+		for (VoteSite voteSite : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 			if (!voteSite.isHidden()) {
 				msg.add(user.voteCommandLastLine(voteSite));
 			}
@@ -49,6 +60,50 @@ public class VoteLast extends GUIHandler {
 		return ArrayUtils.colorize(msg);
 	}
 
+	@Override
+	public void onDialog(Player player) {
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName()).title(plugin.getGui().getChestVoteLastName())
+				.body(plugin.getConfigFile().getFormatCommandsVoteLastTitle()).columns(2);
+
+		for (VoteSite site : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
+			if (site.isHidden()) {
+				continue;
+			}
+
+			dialog.placeholder("sitename", site.getDisplayName()).button(site.getDisplayName(),
+					user.voteCommandLastLine(site), payload -> {
+
+						if (plugin.getGui().isChestVoteLastClickableLinks()) {
+							Player clicked = player.getServer().getPlayer(payload.owner());
+
+							if (clicked != null) {
+								VotingPluginUser clickedUser = plugin.getVotingPluginUserManager()
+										.getVotingPluginUser(clicked);
+
+								HashMap<String, String> placeholders = new HashMap<String, String>();
+								placeholders.put("voteurl", site.getVoteURL());
+								placeholders.put("sitename", site.getDisplayName());
+								placeholders.put("player", clicked.getName());
+
+								clickedUser.sendMessage(plugin.getGui().getChestVoteURLURLText(), placeholders);
+							}
+						}
+					});
+		}
+
+		if (plugin.getGui().isChestVoteLastBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteGUI(plugin, clicked, user).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
+
 	@Override
 	public void onBook(Player player) {
 		// TODO
@@ -63,7 +118,7 @@ public class VoteLast extends GUIHandler {
 	public void onChest(Player player) {
 		BInventory inv = new BInventory(plugin.getGui().getChestVoteLastName());
 		inv.addPlaceholder("player", user.getPlayerName());
-		for (VoteSite site : plugin.getVoteSitesEnabled()) {
+		for (VoteSite site : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 			if (!site.isHidden()) {
 				inv.addButton(inv.getNextSlot(),
 						new UpdatingBInventoryButton(plugin, site.getItem().setName(site.getDisplayName())

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteNext.java

@@ -19,16 +19,26 @@ import com.bencodez.advancedcore.api.messages.PlaceholderUtils;
 import com.bencodez.advancedcore.api.rewards.RewardBuilder;
 import com.bencodez.simpleapi.messages.MessageAPI;
 import com.bencodez.votingplugin.VotingPluginMain;
-import com.bencodez.votingplugin.objects.VoteSite;
 import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
 import xyz.upperlevel.spigot.book.BookUtil;
 
+/**
+ * GUI handler for displaying next vote information.
+ */
 public class VoteNext extends GUIHandler {
 
 	private VotingPluginMain plugin;
 	private VotingPluginUser user;
 
+	/**
+	 * Constructs a new VoteNext GUI handler.
+	 *
+	 * @param plugin the main plugin instance
+	 * @param player the command sender
+	 * @param user   the voting plugin user
+	 */
 	public VoteNext(VotingPluginMain plugin, CommandSender player, VotingPluginUser user) {
 		super(plugin, player);
 		this.plugin = plugin;
@@ -44,7 +54,7 @@ public class VoteNext extends GUIHandler {
 		msg.add(MessageAPI.colorize(MessageAPI
 				.replaceIgnoreCase(plugin.getConfigFile().getFormatCommandsVoteNextTitle(), "%player%", playerName)));
 
-		for (VoteSite voteSite : plugin.getVoteSitesEnabled()) {
+		for (VoteSite voteSite : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 			if (!voteSite.isHidden()) {
 				String msgLine = plugin.getConfigFile().getFormatCommandsVoteNextLayout();
 
@@ -57,12 +67,53 @@ public class VoteNext extends GUIHandler {
 		return msg;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName()).title(plugin.getGui().getChestVoteNextName())
+				.body(plugin.getConfigFile().getFormatCommandsVoteNextTitle()).columns(2);
+
+		for (VoteSite site : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
+			if (site.isHidden()) {
+				continue;
+			}
+
+			String siteNameDisplay = plugin.getGui().getChestVoteNextCustomSiteNamesDisplays(site.getKey());
+
+			if (siteNameDisplay.isEmpty()) {
+				siteNameDisplay = site.getDisplayName();
+			}
+
+			dialog.placeholder("sitename", site.getDisplayName()).placeholder("SiteName", site.getDisplayName())
+					.placeholder("info", user.voteCommandNextInfo(site))
+					.button(siteNameDisplay, user.voteCommandNextInfo(site), payload -> {
+
+						Player clicked = player.getServer().getPlayer(payload.owner());
+
+						if (clicked != null) {
+							clicked.sendMessage(user.voteCommandNextInfo(site));
+						}
+					});
+		}
+
+		if (plugin.getGui().isChestVoteNextBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteGUI(plugin, clicked, user).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
+
 	@Override
 	public void onBook(Player player) {
 		BookWrapper book = new BookWrapper(plugin.getGui().getBookVoteURLBookGUITitle());
 
 		// add colors/config options
-		for (VoteSite site : plugin.getVoteSitesEnabled()) {
+		for (VoteSite site : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 			if (!site.isHidden()) {
 				Layout nextLayout = new Layout(new ArrayList<>(Arrays.asList("[Json]")));
 				nextLayout.replaceTextComponent("[Json]",
@@ -86,7 +137,7 @@ public class VoteNext extends GUIHandler {
 	public void onChest(Player player) {
 		BInventory inv = new BInventory(plugin.getGui().getChestVoteNextName());
 		inv.addPlaceholder("player", user.getPlayerName());
-		for (VoteSite site : plugin.getVoteSitesEnabled()) {
+		for (VoteSite site : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 			if (!site.isHidden()) {
 				String siteNameDisplay = plugin.getGui().getChestVoteNextCustomSiteNamesDisplays(site.getKey());
 				if (siteNameDisplay.isEmpty()) {

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteShop.java

@@ -0,0 +1,260 @@
+package com.bencodez.votingplugin.commands.gui.player;
+
+import java.util.ArrayList;
+
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.advancedcore.api.rewards.RewardBuilder;
+import com.bencodez.simpleapi.messages.MessageAPI;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.voteshop.VoteShopManager;
+import com.bencodez.votingplugin.voteshop.service.VoteShopPurchaseResult;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopCategory;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopCategoryButton;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopDefinition;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopEntry;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopExtraItem;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopItem;
+
+/**
+ * Main vote shop GUI.
+ */
+public class VoteShop extends GUIHandler {
+
+	private VotingPluginMain plugin;
+
+	private VotingPluginUser user;
+
+	/**
+	 * Creates the GUI.
+	 *
+	 * @param plugin the plugin
+	 * @param player the sender
+	 * @param user   the user
+	 */
+	public VoteShop(VotingPluginMain plugin, CommandSender player, VotingPluginUser user) {
+		super(plugin, player);
+		this.plugin = plugin;
+		this.user = user;
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onDialog(Player player) {
+
+	}
+
+	@Override
+	public void onChest(Player player) {
+		VoteShopManager manager = plugin.getVoteShopManager();
+		VoteShopDefinition definition = manager.getDefinition();
+
+		if (!definition.isEnabled()) {
+			player.sendMessage(MessageAPI.colorize(definition.getDisabledMessage()));
+			return;
+		}
+
+		VotingPluginUser currentUser = getUser(player);
+		BInventory inv = new BInventory(definition.getTitle());
+		inv.addPlaceholder("points", String.valueOf(currentUser.getPoints()));
+		inv.addPlaceholder("sitesavailable", String.valueOf(currentUser.getSitesNotVotedOn()));
+		inv.dontClose();
+
+		for (VoteShopEntry entry : definition.getMainEntries().values()) {
+			if (entry instanceof VoteShopItem) {
+				addItemButton(inv, player, currentUser, (VoteShopItem) entry, null);
+			} else if (entry instanceof VoteShopCategoryButton) {
+				addCategoryButton(inv, player, currentUser, (VoteShopCategoryButton) entry);
+			}
+		}
+
+		for (VoteShopExtraItem extraItem : definition.getExtraItems().values()) {
+			addExtraItemButton(inv, player, currentUser, extraItem);
+		}
+
+		if (definition.isBackButton()) {
+			inv.addButton(plugin.getCommandLoader().getBackButton(currentUser));
+		}
+
+		inv.openInventory(player);
+	}
+
+	/**
+	 * Adds an item button.
+	 *
+	 * @param inv         the inventory
+	 * @param player      the player
+	 * @param currentUser the user
+	 * @param item        the item
+	 * @param category    the category, null for main shop
+	 */
+	protected void addItemButton(BInventory inv, final Player player, final VotingPluginUser currentUser,
+			final VoteShopItem item, final VoteShopCategory category) {
+		VoteShopPurchaseResult validation = plugin.getVoteShopManager().getPurchaseService().validatePurchase(player,
+				currentUser, item);
+		boolean hasPermission = plugin.getVoteShopManager().getPurchaseService().hasPermission(player,
+				item.getPermission());
+
+		if ((!hasPermission && item.isHideOnNoPermission()) || (validation == VoteShopPurchaseResult.LIMIT_REACHED
+				&& plugin.getVoteShopManager().getDefinition().isHideLimitedReached())) {
+			return;
+		}
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(item.getDisplaySection())) {
+
+			@Override
+			public void onClick(ClickEvent event) {
+				VotingPluginUser clickedUser = getUser(event.getPlayer());
+				if (plugin.getConfigFile().isExtraVoteShopCheck()) {
+					clickedUser.cache();
+				}
+
+				if (item.isNotBuyable()) {
+					clickedUser.sendMessage(plugin.getConfigFile().getFormatShopNotPurchasable());
+					return;
+				}
+
+				VoteShopPurchaseResult clickValidation = plugin.getVoteShopManager().getPurchaseService()
+						.validatePurchase(event.getPlayer(), clickedUser, item);
+				if (clickValidation != VoteShopPurchaseResult.SUCCESS) {
+					plugin.getVoteShopManager().getPurchaseService().sendFailureMessage(event.getPlayer(), clickedUser,
+							item, clickValidation);
+					return;
+				}
+
+				if (item.isRequireConfirmation()) {
+					if (plugin.getShopFile().isShopConfirmPurchaseUseDialog()) {
+						new VoteShopConfirm(plugin, event.getPlayer(), clickedUser, item, category)
+								.open(GUIMethod.DIALOG);
+						return;
+					} else {
+						new VoteShopConfirm(plugin, event.getPlayer(), clickedUser, item, category)
+								.open(GUIMethod.CHEST);
+						return;
+					}
+				}
+
+				handlePurchase(event.getPlayer(), clickedUser, item, category);
+			}
+		}.addData("identifier", item.getIdentifier()));
+	}
+
+	/**
+	 * Adds a category button.
+	 *
+	 * @param inv         the inventory
+	 * @param player      the player
+	 * @param currentUser the user
+	 * @param button      the button
+	 */
+	protected void addCategoryButton(BInventory inv, final Player player, final VotingPluginUser currentUser,
+			final VoteShopCategoryButton button) {
+		boolean hasPermission = plugin.getVoteShopManager().getPurchaseService().hasPermission(player,
+				button.getPermission());
+		if (!hasPermission && button.isHideOnNoPermission()) {
+			return;
+		}
+
+		final VoteShopCategory category = plugin.getVoteShopManager().getCategory(button.getCategoryId());
+		if (category == null) {
+			plugin.extraDebug(
+					"VoteShop: missing category '" + button.getCategoryId() + "' for entry " + button.getIdentifier());
+			return;
+		}
+
+		inv.addButton(new BInventoryButton(new ItemBuilder(button.getDisplaySection())) {
+
+			@Override
+			public void onClick(ClickEvent event) {
+				new VoteShopCategoryMenu(plugin, event.getPlayer(), currentUser, category).open(GUIMethod.CHEST);
+			}
+		}.addData("identifier", button.getIdentifier()));
+	}
+
+	/**
+	 * Adds an extra item button.
+	 *
+	 * @param inv         the inventory
+	 * @param player      the player
+	 * @param currentUser the user
+	 * @param extraItem   the extra item
+	 */
+	protected void addExtraItemButton(BInventory inv, final Player player, final VotingPluginUser currentUser,
+			final VoteShopExtraItem extraItem) {
+		inv.addButton(new BInventoryButton(new ItemBuilder(extraItem.getDisplaySection())) {
+
+			@Override
+			public void onClick(ClickEvent clickEvent) {
+				plugin.getCommandLoader().processSlotClick(player, currentUser, extraItem.getIdentifier());
+				new RewardBuilder(plugin.getShopFile().getData(),
+						"ExtraItems." + extraItem.getIdentifier() + "."
+								+ clickEvent.getButton().getLastRewardsPath(player))
+						.setGiveOffline(false).send(clickEvent.getPlayer());
+			}
+		});
+	}
+
+	/**
+	 * Handles a completed purchase.
+	 *
+	 * @param player      the player
+	 * @param currentUser the user
+	 * @param item        the item
+	 * @param category    the category or null
+	 */
+	protected void handlePurchase(Player player, VotingPluginUser currentUser, VoteShopItem item,
+			VoteShopCategory category) {
+		VoteShopPurchaseResult result = plugin.getVoteShopManager().purchase(player, currentUser, item);
+		if (result != VoteShopPurchaseResult.SUCCESS) {
+			plugin.getVoteShopManager().getPurchaseService().sendFailureMessage(player, currentUser, item, result);
+			return;
+		}
+
+		plugin.getCommandLoader().processSlotClick(player, currentUser, item.getIdentifier());
+		if (plugin.getVoteShopManager().getDefinition().isReopenGuiOnPurchase()) {
+			if (category != null) {
+				new VoteShopCategoryMenu(plugin, player, currentUser, category).open(GUIMethod.CHEST);
+			} else {
+				plugin.getCommandLoader().processSlotClick(player, currentUser, "shop");
+			}
+		}
+	}
+
+	/**
+	 * Gets the current user.
+	 *
+	 * @param player the player
+	 * @return the user
+	 */
+	protected VotingPluginUser getUser(Player player) {
+		if (user == null) {
+			user = plugin.getVotingPluginUserManager().getVotingPluginUser(player);
+		}
+		return plugin.getVotingPluginUserManager().getVotingPluginUser(player);
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteShopCategoryMenu.java

@@ -0,0 +1,167 @@
+package com.bencodez.votingplugin.commands.gui.player;
+
+import java.util.ArrayList;
+
+import org.bukkit.Material;
+import org.bukkit.command.CommandSender;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.simpleapi.messages.MessageAPI;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopCategory;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopCategoryButton;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopEntry;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopItem;
+
+/**
+ * Vote shop category GUI.
+ */
+public class VoteShopCategoryMenu extends GUIHandler {
+
+	private VoteShopCategory category;
+
+	private VotingPluginMain plugin;
+
+	@SuppressWarnings("unused")
+	private VotingPluginUser user;
+
+	/**
+	 * Creates the GUI.
+	 *
+	 * @param plugin   the plugin
+	 * @param player   the sender
+	 * @param user     the user
+	 * @param category the category
+	 */
+	public VoteShopCategoryMenu(VotingPluginMain plugin, CommandSender player, VotingPluginUser user,
+			VoteShopCategory category) {
+		super(plugin, player);
+		this.plugin = plugin;
+		this.user = user;
+		this.category = category;
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+	@Override
+	public void onDialog(Player player) {
+		
+	}
+
+	@Override
+	public void onChest(Player player) {
+		if (!plugin.getVoteShopManager().getDefinition().isEnabled()) {
+			player.sendMessage(MessageAPI.colorize(plugin.getVoteShopManager().getDefinition().getDisabledMessage()));
+			return;
+		}
+
+		VotingPluginUser currentUser = plugin.getVotingPluginUserManager().getVotingPluginUser(player);
+		BInventory inv = new BInventory(category.getName());
+		inv.addPlaceholder("points", String.valueOf(currentUser.getPoints()));
+		inv.addPlaceholder("sitesavailable", String.valueOf(currentUser.getSitesNotVotedOn()));
+		inv.dontClose();
+
+		for (VoteShopEntry entry : category.getEntries().values()) {
+			if (entry instanceof VoteShopItem) {
+				addItemButton(inv, player, currentUser, (VoteShopItem) entry);
+			} else if (entry instanceof VoteShopCategoryButton) {
+				addCategoryButton(inv, player, currentUser, (VoteShopCategoryButton) entry);
+			}
+		}
+
+		if (category.isBackButton()) {
+			addBackButton(inv, player, currentUser, category.getId());
+		}
+
+		inv.openInventory(player);
+	}
+
+	private void addBackButton(BInventory inv, Player player, VotingPluginUser user, String category) {
+
+		if (!plugin.getShopFile().isCategoryBackButtonEnabled(category)) {
+			return;
+		}
+
+		ConfigurationSection section = plugin.getShopFile().getCategoryBackButtonItem(category);
+
+		if (section == null) {
+			section = plugin.getShopFile().getDefaultBackButtonItem();
+		}
+
+		ItemBuilder builder;
+
+		if (section != null) {
+			builder = new ItemBuilder(section);
+		} else {
+			builder = new ItemBuilder(Material.ARROW);
+			builder.setName("&cBack");
+		}
+
+		inv.addButton(new BInventoryButton(builder) {
+
+			@Override
+			public void onClick(ClickEvent event) {
+				new VoteShop(plugin, player, user).open();
+			}
+
+		});
+	}
+
+	/**
+	 * Adds an item button.
+	 *
+	 * @param inv         the inventory
+	 * @param player      the player
+	 * @param currentUser the user
+	 * @param item        the item
+	 */
+	protected void addItemButton(BInventory inv, final Player player, final VotingPluginUser currentUser,
+			final VoteShopItem item) {
+		new VoteShop(plugin, player, currentUser).addItemButton(inv, player, currentUser, item, category);
+	}
+
+	/**
+	 * Adds a category button.
+	 *
+	 * @param inv         the inventory
+	 * @param player      the player
+	 * @param currentUser the user
+	 * @param button      the button
+	 */
+	protected void addCategoryButton(BInventory inv, final Player player, final VotingPluginUser currentUser,
+			final VoteShopCategoryButton button) {
+		inv.addButton(new BInventoryButton(new ItemBuilder(button.getDisplaySection())) {
+
+			@Override
+			public void onClick(ClickEvent event) {
+				VoteShopCategory target = plugin.getVoteShopManager().getCategory(button.getCategoryId());
+				if (target != null) {
+					new VoteShopCategoryMenu(plugin, event.getPlayer(), currentUser, target).open(GUIMethod.CHEST);
+				}
+			}
+		});
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteShopConfirm.java

@@ -0,0 +1,158 @@
+package com.bencodez.votingplugin.commands.gui.player;
+
+import java.util.ArrayList;
+
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import com.bencodez.advancedcore.api.gui.GUIHandler;
+import com.bencodez.advancedcore.api.gui.GUIMethod;
+import com.bencodez.advancedcore.api.inventory.BInventory;
+import com.bencodez.advancedcore.api.inventory.BInventory.ClickEvent;
+import com.bencodez.advancedcore.api.inventory.BInventoryButton;
+import com.bencodez.advancedcore.api.item.ItemBuilder;
+import com.bencodez.simpleapi.player.PlayerUtils;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.voteshop.service.VoteShopPurchaseResult;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopCategory;
+import com.bencodez.votingplugin.voteshop.shop.VoteShopItem;
+
+/**
+ * Confirmation GUI for vote shop purchases.
+ */
+public class VoteShopConfirm extends GUIHandler {
+
+	private VoteShopCategory category;
+
+	private VoteShopItem item;
+
+	private VotingPluginMain plugin;
+
+	private VotingPluginUser user;
+
+	/**
+	 * Creates the GUI.
+	 *
+	 * @param plugin   the plugin
+	 * @param player   the sender
+	 * @param user     the user
+	 * @param item     the item
+	 * @param category the category or null
+	 */
+	public VoteShopConfirm(VotingPluginMain plugin, CommandSender player, VotingPluginUser user, VoteShopItem item,
+			VoteShopCategory category) {
+		super(plugin, player);
+		this.plugin = plugin;
+		this.user = user;
+		this.item = item;
+		this.category = category;
+	}
+
+	@Override
+	public ArrayList<String> getChat(CommandSender sender) {
+		return null;
+	}
+
+	@Override
+	public void onBook(Player player) {
+	}
+
+	@Override
+	public void onChat(CommandSender sender) {
+	}
+
+	@Override
+	public void onChest(final Player player) {
+		PlayerUtils.setPlayerMeta(plugin, player, "ident", item.getIdentifier());
+		BInventory inv = new BInventory(plugin.getShopFile().getShopConfirmPurchaseTitle());
+		inv.dontClose();
+		inv.addButton(new BInventoryButton(new ItemBuilder(plugin.getShopFile().getShopConfirmPurchaseYesItem())) {
+
+			@Override
+			public void onClick(ClickEvent event) {
+				user.cache();
+				VoteShopPurchaseResult result = plugin.getVoteShopManager().purchase(player, user, item);
+				if (result != VoteShopPurchaseResult.SUCCESS) {
+					plugin.getVoteShopManager().getPurchaseService().sendFailureMessage(player, user, item, result);
+					returnToPrevious(event.getPlayer());
+					return;
+				}
+
+				plugin.getCommandLoader().processSlotClick(player, user, item.getIdentifier());
+				if (item.isCloseGUI()) {
+					event.closeInventory();
+				} else {
+					returnToPrevious(event.getPlayer());
+				}
+			}
+		});
+		inv.addButton(new BInventoryButton(new ItemBuilder(plugin.getShopFile().getShopConfirmPurchaseNoItem())) {
+
+			@Override
+			public void onClick(ClickEvent event) {
+				if (item.isCloseGUI()) {
+					event.closeInventory();
+				} else {
+					returnToPrevious(event.getPlayer());
+				}
+			}
+		});
+		inv.openInventory(player);
+	}
+
+	@Override
+	public void onDialog(Player player) {
+		PlayerUtils.setPlayerMeta(plugin, player, "ident", item.getIdentifier());
+
+		plugin.getDialogService().confirmation(player).placeholder("player", user.getPlayerName())
+				.placeholder("identifier", item.getIdentifier())
+				.title(plugin.getShopFile().getShopConfirmPurchaseTitle())
+				.body("&7Confirm purchase of &e%identifier%&7?")
+				.yesText(new ItemBuilder(plugin.getShopFile().getShopConfirmPurchaseYesItem()).getName())
+				.noText(new ItemBuilder(plugin.getShopFile().getShopConfirmPurchaseNoItem()).getName())
+				.onYes(payload -> {
+					Player clicked = player.getServer().getPlayer(payload.owner());
+					if (clicked == null) {
+						return;
+					}
+
+					user.cache();
+					VoteShopPurchaseResult result = plugin.getVoteShopManager().purchase(clicked, user, item);
+					if (result != VoteShopPurchaseResult.SUCCESS) {
+						plugin.getVoteShopManager().getPurchaseService().sendFailureMessage(clicked, user, item,
+								result);
+						returnToPrevious(clicked);
+						return;
+					}
+
+					plugin.getCommandLoader().processSlotClick(clicked, user, item.getIdentifier());
+					if (!item.isCloseGUI()) {
+						returnToPrevious(clicked);
+					}
+				}).onNo(payload -> {
+					Player clicked = player.getServer().getPlayer(payload.owner());
+					if (clicked != null) {
+						returnToPrevious(clicked);
+					}
+				}).open();
+	}
+
+	/**
+	 * Returns to the previous GUI.
+	 *
+	 * @param player the player
+	 */
+	protected void returnToPrevious(Player player) {
+		if (category != null) {
+			new VoteShopCategoryMenu(plugin, player, user, category).open(GUIMethod.CHEST);
+		} else {
+			new VoteShop(plugin, player, user).open(GUIMethod.CHEST);
+		}
+	}
+
+	@Override
+	public void open() {
+		open(GUIMethod.CHEST);
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteStreak.java

@@ -29,6 +29,57 @@ public class VoteStreak extends GUIHandler {
 		this.plugin = plugin;
 		this.user = user;
 	}
+	
+	@Override
+	public void onDialog(Player player) {
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName())
+				.placeholder("DailyStreak", "" + user.getDayVoteStreak())
+				.placeholder("WeeklyStreak", "" + user.getWeekVoteStreak())
+				.placeholder("MonthlyStreak", "" + user.getMonthVoteStreak())
+				.placeholder("BestDailyStreak", "" + user.getBestDayVoteStreak())
+				.placeholder("BestWeeklyStreak", "" + user.getBestWeekVoteStreak())
+				.placeholder("BestMonthlyStreak", "" + user.getBestMonthVoteStreak())
+				.title(plugin.getGui().getChestVoteStreakName())
+				.body(plugin.getConfigFile().getFormatCommandsVoteStreakTitle())
+				.columns(2);
+
+		dialog.button(plugin.getGui().getChestVoteStreakCurrentDayStreakItem().getName(),
+				"&7Current daily streak: &e%DailyStreak%",
+				payload -> {
+				});
+		dialog.button(plugin.getGui().getChestVoteStreakCurrentWeekStreakItem().getName(),
+				"&7Current weekly streak: &e%WeeklyStreak%",
+				payload -> {
+				});
+		dialog.button(plugin.getGui().getChestVoteStreakCurrentMonthStreakItem().getName(),
+				"&7Current monthly streak: &e%MonthlyStreak%",
+				payload -> {
+				});
+		dialog.button(plugin.getGui().getChestVoteStreakHighestDayStreakItem().getName(),
+				"&7Best daily streak: &e%BestDailyStreak%",
+				payload -> {
+				});
+		dialog.button(plugin.getGui().getChestVoteStreakHighestWeekStreakItem().getName(),
+				"&7Best weekly streak: &e%BestWeeklyStreak%",
+				payload -> {
+				});
+		dialog.button(plugin.getGui().getChestVoteStreakHighestMonthStreakItem().getName(),
+				"&7Best monthly streak: &e%BestMonthlyStreak%",
+				payload -> {
+				});
+
+		if (plugin.getGui().isChestVoteStreakBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteGUI(plugin, clicked, user).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
 
 	@Override
 	public ArrayList<String> getChat(CommandSender sender) {

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteToday.java

@@ -19,11 +19,10 @@ import com.bencodez.advancedcore.api.item.ItemBuilder;
 import com.bencodez.advancedcore.api.messages.PlaceholderUtils;
 import com.bencodez.advancedcore.api.rewards.RewardBuilder;
 import com.bencodez.simpleapi.array.ArrayUtils;
-import com.bencodez.simpleapi.nms.NMSManager;
 import com.bencodez.votingplugin.VotingPluginMain;
-import com.bencodez.votingplugin.objects.VoteSite;
 import com.bencodez.votingplugin.topvoter.TopVoterPlayer;
 import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
 public class VoteToday extends GUIHandler {
 
@@ -38,6 +37,49 @@ public class VoteToday extends GUIHandler {
 		this.page = page;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName()).placeholder("page", "" + page)
+				.title(plugin.getGui().getChestVoteTodayName())
+				.body(String.join("\n", plugin.getConfigFile().getFormatCommandsVoteTodayTitle())).columns(2);
+
+		for (TopVoterPlayer topPlayer : plugin.getVoteToday().keySet()) {
+			for (VoteSite voteSite : plugin.getVoteToday().get(topPlayer).keySet()) {
+				DateTimeFormatter formatter = DateTimeFormatter.ofPattern(plugin.getConfigFile().getFormatTimeFormat());
+				String timeString = plugin.getVoteToday().get(topPlayer).get(voteSite).format(formatter);
+
+				final UUID uuid = topPlayer.getUuid();
+
+				dialog.placeholder("player", topPlayer.getPlayerName()).placeholder("votesite", voteSite.getKey())
+						.placeholder("sitename", voteSite.getDisplayName())
+						.placeholder("SiteName", voteSite.getDisplayName())
+						.placeholder("VoteSite", voteSite.getDisplayName()).placeholder("time", timeString)
+						.placeholder("Time", timeString).button("&e" + topPlayer.getPlayerName(),
+								plugin.getConfigFile().getFormatCommandsVoteTodayLine(), payload -> {
+									Player clicked = player.getServer().getPlayer(payload.owner());
+									if (clicked != null) {
+										VotingPluginUser clickedUser = plugin.getVotingPluginUserManager()
+												.getVotingPluginUser(uuid);
+										new VoteGUI(plugin, clicked, clickedUser).open(
+												GUIMethod.valueOf(plugin.getGui().getGuiMethodGUI().toUpperCase()));
+									}
+								});
+			}
+		}
+
+		if (plugin.getGui().isChestVoteTodayBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteGUI(plugin, clicked, user).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
+
 	@Override
 	public ArrayList<String> getChat(CommandSender arg0) {
 		int pagesize = plugin.getConfigFile().getFormatPageSize();
@@ -85,28 +127,38 @@ public class VoteToday extends GUIHandler {
 		if (!plugin.getConfigFile().isAlwaysCloseInventory()) {
 			inv.dontClose();
 		}
-		for (TopVoterPlayer user : plugin.getVoteToday().keySet()) {
 
+		for (TopVoterPlayer user : plugin.getVoteToday().keySet()) {
 			for (VoteSite voteSite : plugin.getVoteToday().get(user).keySet()) {
 				DateTimeFormatter formatter = DateTimeFormatter.ofPattern(plugin.getConfigFile().getFormatTimeFormat());
 				String timeString = plugin.getVoteToday().get(user).get(voteSite).format(formatter);
-				String msg = plugin.getGui().getChestVoteTodayLine();
+
 				HashMap<String, String> placeholders = new HashMap<>();
+				placeholders.put("player", user.getPlayerName());
+				placeholders.put("votesite", voteSite.getKey());
+				placeholders.put("sitename", voteSite.getDisplayName());
+				placeholders.put("SiteName", voteSite.getDisplayName());
 				placeholders.put("VoteSite", voteSite.getDisplayName());
+				placeholders.put("time", timeString);
 				placeholders.put("Time", timeString);
-				msg = PlaceholderUtils.replacePlaceHolder(msg, placeholders);
-				ItemBuilder item = null;
-				if (plugin.getGui().isChestVoteTodayUseSkull() && !NMSManager.getInstance().isVersion("1.12")) {
+
+				ItemBuilder item;
+				if (plugin.getGui().isChestVoteTodayUseSkull()) {
 					item = new ItemBuilder(user.getPlayerHead());
 				} else {
 					item = new ItemBuilder(plugin.getGui().getChestVoteTodayPlayerItem());
 				}
-				item.setName(PlaceholderUtils.replacePlaceHolder(plugin.getGui().getChestVoteTodayIconTitle(), "player",
-						user.getPlayerName()));
-				item.setLore(msg);
+
+				String title = PlaceholderUtils.replacePlaceHolder(plugin.getGui().getChestVoteTodayIconTitle(),
+						placeholders);
+				String lore = PlaceholderUtils.replacePlaceHolder(plugin.getGui().getChestVoteTodayLine(),
+						placeholders);
+
+				item.setName(title);
+				item.setLore(lore);
+
 				final UUID uuid = user.getUuid();
 				inv.addButton(inv.getNextSlot(), new BInventoryButton(item) {
-
 					@Override
 					public void onClick(ClickEvent clickEvent) {
 						VotingPluginUser user = plugin.getVotingPluginUserManager().getVotingPluginUser(uuid);
@@ -121,16 +173,13 @@ public class VoteToday extends GUIHandler {
 		for (final String str : plugin.getGui().getChestGUIExtraItems(guiPath)) {
 			inv.addButton(
 					new BInventoryButton(new ItemBuilder(plugin.getGui().getChestGUIExtraItemsItem(guiPath, str))) {
-
 						@Override
 						public void onClick(ClickEvent clickEvent) {
 							new RewardBuilder(plugin.getGui().getData(),
 									"CHEST." + guiPath + ".ExtraItems." + str + "."
 											+ clickEvent.getButton().getLastRewardsPath(player))
 									.setGiveOffline(false).send(clickEvent.getPlayer());
-
 						}
-
 					});
 		}
 
@@ -155,7 +204,7 @@ public class VoteToday extends GUIHandler {
 				HashMap<String, String> placeholders = new HashMap<>();
 				placeholders.put("player", user.getPlayerName());
 				placeholders.put("votesite", voteSite.getKey());
-                                placeholders.put("sitename", voteSite.getDisplayName());
+				placeholders.put("sitename", voteSite.getDisplayName());
 				placeholders.put("time", timeString);
 				msg.add(PlaceholderUtils.replacePlaceHolder(plugin.getConfigFile().getFormatCommandsVoteTodayLine(),
 						placeholders));
@@ -185,7 +234,7 @@ public class VoteToday extends GUIHandler {
 				HashMap<String, String> placeholders = new HashMap<>();
 				placeholders.put("player", user.getPlayerName());
 				placeholders.put("votesite", mostRecentSite.getKey());
-                                placeholders.put("sitename", mostRecentSite.getDisplayName());
+				placeholders.put("sitename", mostRecentSite.getDisplayName());
 				placeholders.put("time", timeString);
 				msg.add(PlaceholderUtils.replacePlaceHolder(plugin.getConfigFile().getFormatCommandsVoteTodayLine(),
 						placeholders));

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteTopVoter.java

@@ -41,6 +41,74 @@ public class VoteTopVoter extends GUIHandler {
 		this.top = top;
 		this.page = page;
 	}
+	
+	@Override
+	public void onDialog(Player player) {
+		if (top == null) {
+			top = TopVoter.getDefault();
+		}
+
+		String topVoter = top.getName();
+
+		@SuppressWarnings("unchecked")
+		LinkedHashMap<TopVoterPlayer, Integer> topVotes = (LinkedHashMap<TopVoterPlayer, Integer>) plugin.getTopVoter(top)
+				.clone();
+
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName())
+				.placeholder("topvoter", topVoter)
+				.title(plugin.getGui().getChestVoteTopName())
+				.body("&7Viewing &e%topvoter% &7top voters")
+				.columns(2);
+
+		int pos = 1;
+		for (Entry<TopVoterPlayer, Integer> entry : topVotes.entrySet()) {
+			final TopVoterPlayer topPlayer = entry.getKey();
+			final int votes = entry.getValue();
+			final int position = pos;
+
+			dialog.placeholder("position", "" + position)
+					.placeholder("player", topPlayer.getPlayerName())
+					.placeholder("votes", "" + votes)
+					.button(plugin.getGui().getChestVoteTopItemName(),
+							plugin.getGui().getChestVoteTopItemLore(),
+							payload -> {
+								if (plugin.getGui().isChestVoteTopOpenMainGUIOnClick()) {
+									Player clicked = player.getServer().getPlayer(payload.owner());
+									if (clicked != null) {
+										new VoteGUI(plugin, clicked, topPlayer.getUser()).open(
+												GUIMethod.valueOf(plugin.getGui().getGuiMethodGUI().toUpperCase()));
+									}
+								}
+							});
+			pos++;
+		}
+
+		dialog.button("&eNext", "&7View next top voter board", payload -> {
+			Player clicked = player.getServer().getPlayer(payload.owner());
+			if (clicked != null) {
+				new VoteTopVoter(plugin, clicked, user, top.next(), 0).open(GUIMethod.DIALOG);
+			}
+		});
+
+		dialog.button("&ePrevious", "&7View previous top voter board", payload -> {
+			Player clicked = player.getServer().getPlayer(payload.owner());
+			if (clicked != null) {
+				new VoteTopVoter(plugin, clicked, user, top.prev(), 0).open(GUIMethod.DIALOG);
+			}
+		});
+
+		if (plugin.getGui().isChestVoteTopBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteGUI(plugin, clicked, user).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
 
 	@Override
 	public ArrayList<String> getChat(CommandSender sender) {

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteTopVoterLastMonth.java

@@ -28,6 +28,50 @@ public class VoteTopVoterLastMonth extends GUIHandler {
 		this.plugin = plugin;
 		this.user = user;
 	}
+	
+	@Override
+	public void onDialog(Player player) {
+		Set<Entry<TopVoterPlayer, Integer>> users = plugin.getLastMonthTopVoter().entrySet();
+
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName())
+				.placeholder("topvoter", "Last Month")
+				.title(plugin.getGui().getChestVoteTopName())
+				.body("&7Viewing &eLast Month &7top voters")
+				.columns(2);
+
+		int pos = 1;
+		for (Entry<TopVoterPlayer, Integer> entry : users) {
+			final TopVoterPlayer topPlayer = entry.getKey();
+			final int votes = entry.getValue();
+			final int position = pos;
+
+			dialog.placeholder("position", "" + position)
+					.placeholder("player", topPlayer.getPlayerName())
+					.placeholder("votes", "" + votes)
+					.button(plugin.getGui().getChestVoteTopItemName(),
+							plugin.getGui().getChestVoteTopItemLore(),
+							payload -> {
+								Player clicked = player.getServer().getPlayer(payload.owner());
+								if (clicked != null) {
+									new VoteGUI(plugin, clicked, topPlayer.getUser())
+											.open(GUIMethod.valueOf(plugin.getGui().getGuiMethodGUI().toUpperCase()));
+								}
+							});
+			pos++;
+		}
+
+		if (plugin.getGui().isChestVoteTopBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteGUI(plugin, clicked, user).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
 
 	@Override
 	public ArrayList<String> getChat(CommandSender arg0) {

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteTopVoterPreviousMonths.java

@@ -23,8 +23,7 @@ import com.bencodez.votingplugin.VotingPluginMain;
 import com.bencodez.votingplugin.topvoter.TopVoterPlayer;
 import com.bencodez.votingplugin.user.VotingPluginUser;
 
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.format.NamedTextColor;
+import net.md_5.bungee.api.ChatColor;
 
 public class VoteTopVoterPreviousMonths extends GUIHandler {
 
@@ -38,6 +37,84 @@ public class VoteTopVoterPreviousMonths extends GUIHandler {
 		this.user = user;
 		this.index = index;
 	}
+	
+	@Override
+	public void onDialog(Player player) {
+		Set<YearMonth> months = plugin.getPreviousMonthsTopVoters().keySet();
+		List<YearMonth> yearMonthList = months.stream().sorted(Collections.reverseOrder()).collect(Collectors.toList());
+
+		if (index < 0 || yearMonthList.isEmpty()) {
+			player.sendMessage(ChatColor.RED + "Can't open previous months, no data");
+			return;
+		}
+
+		if (yearMonthList.size() <= index) {
+			player.sendMessage(ChatColor.RED + "Can't open previous months, no data for requested index");
+			return;
+		}
+
+		YearMonth yearMonth = yearMonthList.get(index);
+
+		if (!plugin.getPreviousMonthsTopVoters().containsKey(yearMonth)) {
+			player.sendMessage(ChatColor.RED + "Can't open previous months, no data");
+			return;
+		}
+
+		Set<Entry<TopVoterPlayer, Integer>> users = plugin.getPreviousMonthsTopVoters().get(yearMonth).entrySet();
+
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName())
+				.placeholder("topvoter", yearMonth.toString())
+				.title(plugin.getGui().getChestVoteTopName())
+				.body("&7Viewing &e%topvoter% &7top voters")
+				.columns(2);
+
+		int pos = 1;
+		for (Entry<TopVoterPlayer, Integer> entry : users) {
+			final TopVoterPlayer topPlayer = entry.getKey();
+			final int votes = entry.getValue();
+			final int position = pos;
+
+			dialog.placeholder("position", "" + position)
+					.placeholder("player", topPlayer.getPlayerName())
+					.placeholder("votes", "" + votes)
+					.button(plugin.getGui().getChestVoteTopItemName(),
+							plugin.getGui().getChestVoteTopItemLore(),
+							payload -> {
+								Player clicked = player.getServer().getPlayer(payload.owner());
+								if (clicked != null) {
+									new VoteGUI(plugin, clicked, topPlayer.getUser())
+											.open(GUIMethod.valueOf(plugin.getGui().getGuiMethodGUI().toUpperCase()));
+								}
+							});
+			pos++;
+		}
+
+		dialog.button("&eNext Month", "&7View older month", payload -> {
+			Player clicked = player.getServer().getPlayer(payload.owner());
+			if (clicked != null) {
+				new VoteTopVoterPreviousMonths(plugin, clicked, user, index + 1).open(GUIMethod.DIALOG);
+			}
+		});
+
+		dialog.button("&ePrevious Month", "&7View newer month", payload -> {
+			Player clicked = player.getServer().getPlayer(payload.owner());
+			if (clicked != null) {
+				new VoteTopVoterPreviousMonths(plugin, clicked, user, index - 1).open(GUIMethod.DIALOG);
+			}
+		});
+
+		if (plugin.getGui().isChestVoteTopBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteGUI(plugin, clicked, user).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
 
 	@Override
 	public ArrayList<String> getChat(CommandSender arg0) {
@@ -69,19 +146,18 @@ public class VoteTopVoterPreviousMonths extends GUIHandler {
 			if (!yearMonthList.isEmpty()) {
 				yearMonth = yearMonthList.get(0);
 			}
-			player.sendMessage(Component.text("Can't open previous months, no data", NamedTextColor.RED));
+			player.sendMessage(ChatColor.RED + "Can't open previous months, no data");
 			return;
 		}
 		if (yearMonthList.size() <= index) {
-			player.sendMessage(
-					Component.text("Can't open previous months, no data for requested index", NamedTextColor.RED));
+			player.sendMessage(ChatColor.RED + "Can't open previous months, no data for requested index");
 			return;
 		}
 		yearMonth = yearMonthList.get(index);
 
 		Set<Entry<TopVoterPlayer, Integer>> users = null;
 		if (!plugin.getPreviousMonthsTopVoters().containsKey(yearMonth)) {
-			player.sendMessage(Component.text("Can't open previous months, no data", NamedTextColor.RED));
+			player.sendMessage(ChatColor.RED + "Can't open previous months, no data");
 			return;
 		}
 		users = plugin.getPreviousMonthsTopVoters().get(yearMonth).entrySet();

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteTotal.java

@@ -30,6 +30,42 @@ public class VoteTotal extends GUIHandler {
 		this.user = user;
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName())
+				.placeholder("DailyTotal", "" + user.getTotal(TopVoter.Daily))
+				.placeholder("WeeklyTotal", "" + user.getTotal(TopVoter.Weekly))
+				.placeholder("MonthlyTotal", "" + user.getTotal(TopVoter.Monthly))
+				.placeholder("AllTimeTotal", "" + user.getTotal(TopVoter.AllTime))
+				.title(plugin.getGui().getChestVoteTotalName()).body("&7Vote totals for %player%").columns(2);
+
+		for (final TopVoter top : TopVoter.values()) {
+
+			dialog.placeholder("topvoter", top.getName()).placeholder("Total", "" + user.getTotal(top))
+					.button("%topvoter%", "&7Total: &e%Total%", payload -> {
+
+						Player clicked = player.getServer().getPlayer(payload.owner());
+
+						if (clicked != null) {
+							clicked.sendMessage("&e" + top.getName() + ": &a" + user.getTotal(top));
+						}
+					});
+		}
+
+		if (plugin.getGui().isChestVoteTotalBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteGUI(plugin, clicked, user).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
+
 	@Override
 	public ArrayList<String> getChat(CommandSender arg0) {
 		ArrayList<String> msg = new ArrayList<>();

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteURL.java

@@ -23,9 +23,9 @@ import com.bencodez.advancedcore.api.messages.PlaceholderUtils;
 import com.bencodez.advancedcore.api.rewards.RewardBuilder;
 import com.bencodez.simpleapi.array.ArrayUtils;
 import com.bencodez.votingplugin.VotingPluginMain;
-import com.bencodez.votingplugin.objects.VoteSite;
 import com.bencodez.votingplugin.topvoter.TopVoter;
 import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
 import xyz.upperlevel.spigot.book.BookUtil;
 
@@ -43,11 +43,6 @@ public class VoteURL extends GUIHandler {
 		if (user == null && player instanceof Player) {
 			this.user = plugin.getVotingPluginUserManager().getVotingPluginUser((Player) player);
 		}
-		if (player != null && user != null && player.getName().equals(user.getPlayerName())) {
-			if (plugin.getConfigFile().isUsePrimaryAccountForPlaceholders() && user.hasPrimaryAccount()) {
-				user = plugin.getVotingPluginUserManager().getVotingPluginUser(user.getPrimaryAccount());
-			}
-		}
 	}
 
 	@Override
@@ -64,7 +59,7 @@ public class VoteURL extends GUIHandler {
 		}
 		if (plugin.getConfigFile().isFormatCommandsVoteAutoInputSites()) {
 			int counter = 0;
-			for (VoteSite voteSite : plugin.getVoteSitesEnabled()) {
+			for (VoteSite voteSite : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 				if (!voteSite.isHidden()) {
 					if (voteSite.getPermissionToView().isEmpty()
 							|| sender.hasPermission(voteSite.getPermissionToView())) {
@@ -101,6 +96,93 @@ public class VoteURL extends GUIHandler {
 		return ArrayUtils.colorize(sites);
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+		VotingPluginUser currentUser = this.user;
+
+		if (currentUser == null) {
+			currentUser = plugin.getVotingPluginUserManager().getVotingPluginUser(player);
+		}
+
+		String body = "&7Select a vote site";
+
+		if (plugin.getConfigFile().getFormatCommandsVoteText() != null
+				&& !plugin.getConfigFile().getFormatCommandsVoteText().isEmpty()) {
+			body = String.join("\n", plugin.getConfigFile().getFormatCommandsVoteText());
+		}
+
+		final VotingPluginUser finalUser = currentUser;
+
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", finalUser.getPlayerName())
+				.placeholder("DailyTotal", "" + finalUser.getTotal(TopVoter.Daily))
+				.placeholder("WeekTotal", "" + finalUser.getTotal(TopVoter.Weekly))
+				.placeholder("MonthTotal", "" + finalUser.getTotal(TopVoter.Monthly))
+				.placeholder("Total", "" + finalUser.getTotal(TopVoter.AllTime))
+				.title(plugin.getGui().getChestVoteURLName()).body(body).columns(2);
+
+		if (plugin.getGui().isChestVoteURLViewAllUrlsButtonEnabled()) {
+			boolean canViewAll;
+			if (plugin.getGui().isChestVoteURLAllUrlsButtonrequireAllSitesVoted()) {
+				canViewAll = finalUser.canVoteAny();
+			} else {
+				canViewAll = finalUser.canVoteAll();
+			}
+
+			String allColor = canViewAll ? "&a" : "&c";
+
+			dialog.button(allColor + "All Voting Sites", "&7Show all vote URLs", payload -> {
+				VotingPluginUser payloadUser = plugin.getVotingPluginUserManager().getVotingPluginUser(player);
+				json = true;
+				payloadUser.sendMessage(getChat(player, false));
+			});
+		}
+
+		for (final VoteSite voteSite : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
+			if (voteSite.isHidden()) {
+				continue;
+			}
+			if (!voteSite.getPermissionToView().isEmpty() && !player.hasPermission(voteSite.getPermissionToView())) {
+				continue;
+			}
+
+			boolean canVote = finalUser.canVoteSite(voteSite);
+			String color = canVote ? "&a" : "&c";
+
+			dialog.placeholder("sitename", voteSite.getDisplayName())
+					.placeholder("SiteName", voteSite.getDisplayName())
+					.placeholder("servicesite", voteSite.getServiceSite())
+					.placeholder("ServiceSite", voteSite.getServiceSite())
+					.placeholder("VoteDelay", "" + voteSite.getVoteDelay())
+					.placeholder("VoteHour", "" + voteSite.getVoteDelayDailyHour())
+					.placeholder("Next", finalUser.voteCommandNextInfo(voteSite))
+					.button(color + voteSite.getDisplayName(),
+							canVote ? "&aClick to view vote link" : "&c" + finalUser.voteCommandNextInfo(voteSite),
+							payload -> {
+								Player clicked = player.getServer().getPlayer(payload.owner());
+								if (clicked != null) {
+									VotingPluginUser clickedUser = plugin.getVotingPluginUserManager()
+											.getVotingPluginUser(clicked);
+									HashMap<String, String> placeholders = new HashMap<String, String>();
+									placeholders.put("voteurl", voteSite.getVoteURL());
+									placeholders.put("sitename", voteSite.getDisplayName());
+									placeholders.put("player", clicked.getName());
+									placeholders.put("servicesite", voteSite.getServiceSite());
+									placeholders.put("VoteDelay", "" + voteSite.getVoteDelay());
+									placeholders.put("VoteHour", "" + voteSite.getVoteDelayDailyHour());
+									clickedUser.sendMessage(plugin.getGui().getChestVoteURLURLText(), placeholders);
+								}
+							});
+		}
+
+		if (plugin.getGui().isChestVoteURLBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> player.performCommand("vote gui"));
+		}
+
+		dialog.open();
+	}
+
 	private ItemBuilder getItemAll() {
 		ItemBuilder builderAll = new ItemBuilder(plugin.getGui().getChestVoteURLAlreadyVotedAllUrlsButtonItemSection());
 		if (plugin.getGui().isChestVoteURLAllUrlsButtonrequireAllSitesVoted()) {
@@ -154,7 +236,7 @@ public class VoteURL extends GUIHandler {
 			book.addLayout(layout);
 		}
 		int i = 1;
-		for (VoteSite site : plugin.getVoteSitesEnabled()) {
+		for (VoteSite site : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 			if (!site.isHidden()) {
 				if (site.getPermissionToView().isEmpty() || player.hasPermission(site.getPermissionToView())) {
 					Layout layout = new Layout(plugin.getGui().getBookVoteURLBookGUILayout())
@@ -232,7 +314,7 @@ public class VoteURL extends GUIHandler {
 		}
 
 		int startSlot = plugin.getGui().getChestVoteURLAllUrlsButtonStartSlot();
-		for (final VoteSite voteSite : plugin.getVoteSitesEnabled()) {
+		for (final VoteSite voteSite : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
 			if (!voteSite.isHidden()) {
 				if (voteSite.getPermissionToView().isEmpty() || player.hasPermission(voteSite.getPermissionToView())) {
 					ItemBuilder builder = getItemVoteSite(voteSite);

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/gui/player/VoteURLVoteSite.java

@@ -14,8 +14,8 @@ import com.bencodez.advancedcore.api.inventory.BInventoryButton;
 import com.bencodez.advancedcore.api.inventory.UpdatingBInventoryButton;
 import com.bencodez.advancedcore.api.item.ItemBuilder;
 import com.bencodez.votingplugin.VotingPluginMain;
-import com.bencodez.votingplugin.objects.VoteSite;
 import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
 public class VoteURLVoteSite extends GUIHandler {
 
@@ -47,11 +47,11 @@ public class VoteURLVoteSite extends GUIHandler {
 
 	@Override
 	public void onChest(Player player) {
-		if (!plugin.isVoteSite(voteSite)) {
+		if (!plugin.getVoteSiteManager().isVoteSite(voteSite)) {
 			player.sendMessage("Not a valid votesite");
 			return;
 		}
-		VoteSite site = plugin.getVoteSite(voteSite, true);
+		VoteSite site = plugin.getVoteSiteManager().getVoteSite(voteSite, true);
 		BInventory inv = new BInventory(plugin.getGui().getChestVoteURLSiteName());
 		inv.addPlaceholder("site", site.getDisplayName());
 		inv.setMeta(player, "VoteSite", site);
@@ -106,4 +106,56 @@ public class VoteURLVoteSite extends GUIHandler {
 		open(GUIMethod.CHEST);
 	}
 
+	@Override
+	public void onDialog(Player player) {
+
+		if (!plugin.getVoteSiteManager().isVoteSite(voteSite)) {
+			player.sendMessage("Not a valid votesite");
+			return;
+		}
+
+		VoteSite site = plugin.getVoteSiteManager().getVoteSite(voteSite, true);
+
+		com.bencodez.simpleapi.dialog.MultiActionDialogBuilder dialog = plugin.getDialogService().multiAction(player)
+				.placeholder("player", user.getPlayerName()).placeholder("site", site.getDisplayName())
+				.placeholder("sitename", site.getDisplayName()).placeholder("SiteName", site.getDisplayName())
+				.placeholder("servicesite", site.getServiceSite()).placeholder("ServiceSite", site.getServiceSite())
+				.placeholder("VoteDelay", "" + site.getVoteDelay())
+				.placeholder("VoteHour", "" + site.getVoteDelayDailyHour())
+				.placeholder("Next", user.voteCommandNextInfo(site)).placeholder("Last", user.voteCommandLastLine(site))
+				.title(plugin.getGui().getChestVoteURLSiteName()).body("&7Site: &e%site%").columns(2);
+
+		dialog.button("&4URL", "&7Click to see URL", payload -> {
+			Player clicked = player.getServer().getPlayer(payload.owner());
+			if (clicked != null) {
+				clicked.sendMessage(site.getVoteURL());
+			}
+		});
+
+		dialog.button("&4Next Vote", "%Next%", payload -> {
+			Player clicked = player.getServer().getPlayer(payload.owner());
+			if (clicked != null) {
+				new VoteURL(plugin, clicked, user, true).open();
+			}
+		});
+
+		dialog.button("&4Last Vote", "%Last%", payload -> {
+			Player clicked = player.getServer().getPlayer(payload.owner());
+			if (clicked != null) {
+				new VoteURL(plugin, clicked, user, true).open();
+			}
+		});
+
+		if (plugin.getGui().isChestVoteURLBackButton()) {
+			dialog.button("&eBack", "&7Return to previous menu", payload -> {
+				Player clicked = player.getServer().getPlayer(payload.owner());
+				if (clicked != null) {
+					new VoteURL(plugin, clicked, user, true).open();
+				}
+			});
+		}
+
+		dialog.open();
+	}
+
 }

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/tabcompleter/AliasCommandFilterListener.java

@@ -0,0 +1,141 @@
+package com.bencodez.votingplugin.commands.tabcompleter;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.player.PlayerCommandSendEvent;
+
+import com.bencodez.votingplugin.VotingPluginMain;
+
+/**
+ * Filters VotingPlugin command aliases from tab completion when aliases are
+ * disabled.
+ * <p>
+ * This listener ONLY hides aliases that are explicitly listed in VotingPlugin's
+ * plugin.yml under the "aliases:" section for the "vote" and "adminvote"
+ * commands.
+ * <p>
+ * It will NOT hide unrelated commands such as "/votechallenge" unless that
+ * exact command name is an alias defined in VotingPlugin's plugin.yml.
+ */
+public class AliasCommandFilterListener implements Listener {
+
+	private final VotingPluginMain plugin;
+
+	/**
+	 * Cached lowercase alias names (without '/') that should be hidden when alias
+	 * loading is disabled.
+	 */
+	private final Set<String> aliasesToHide;
+
+	/**
+	 * Creates a new listener and caches aliases from VotingPlugin's plugin.yml.
+	 *
+	 * @param plugin VotingPlugin main instance
+	 */
+	public AliasCommandFilterListener(VotingPluginMain plugin) {
+		this.plugin = plugin;
+		this.aliasesToHide = buildAliasesToHide(plugin);
+	}
+
+	/**
+	 * Removes VotingPlugin aliases from the player's available command list when
+	 * alias loading is disabled.
+	 *
+	 * @param event Bukkit command send event
+	 */
+	@EventHandler
+	public void onPlayerCommandSend(PlayerCommandSendEvent event) {
+		// Only hide when aliases feature is disabled
+		if (plugin.getConfigFile().isLoadCommandAliases()) {
+			return;
+		}
+
+		// Remove ONLY exact alias command names (not "vote*" prefixes)
+		event.getCommands().removeIf(this::shouldHideCommand);
+	}
+
+	/**
+	 * Determines whether a specific command should be hidden.
+	 *
+	 * @param cmd Command name (without '/'), possibly namespaced (e.g.
+	 *            "otherplugin:vote")
+	 * @return true if the command should be hidden
+	 */
+	private boolean shouldHideCommand(String cmd) {
+		String name = cmd.toLowerCase(Locale.ROOT);
+
+		// Never touch namespaced commands (otherplugin:vote)
+		if (name.contains(":")) {
+			return false;
+		}
+
+		// Always keep the primary commands visible
+		if (name.equals("vote") || name.equals("adminvote")) {
+			return false;
+		}
+
+		// Hide only exact aliases defined in VotingPlugin plugin.yml
+		return aliasesToHide.contains(name);
+	}
+
+	/**
+	 * Builds the set of aliases to hide from VotingPlugin's plugin.yml.
+	 * <p>
+	 * Bukkit exposes the plugin.yml "commands" section via
+	 * {@code plugin.getDescription().getCommands()}. Each command entry is a map
+	 * that may contain an "aliases" key.
+	 *
+	 * @param plugin VotingPlugin main instance
+	 * @return a lowercase set of alias command names
+	 */
+	private Set<String> buildAliasesToHide(VotingPluginMain plugin) {
+		Set<String> aliases = new HashSet<>();
+
+		Map<String, Map<String, Object>> commands = plugin.getDescription().getCommands();
+		if (commands == null || commands.isEmpty()) {
+			return Collections.emptySet();
+		}
+
+		// Only consider aliases for these main commands
+		addAliasesFor(commands, "vote", aliases);
+		addAliasesFor(commands, "adminvote", aliases);
+
+		return Collections.unmodifiableSet(aliases);
+	}
+
+	/**
+	 * Adds aliases for a given command from the plugin.yml commands map into the
+	 * provided set.
+	 *
+	 * @param commandsMap full commands map from PluginDescriptionFile
+	 * @param commandName the primary command to read aliases for (e.g. "vote")
+	 * @param out         output set to add lowercase alias names into
+	 */
+	@SuppressWarnings("unchecked")
+	private static void addAliasesFor(Map<String, Map<String, Object>> commandsMap, String commandName,
+			Set<String> out) {
+		Map<String, Object> cmdInfo = commandsMap.get(commandName);
+		if (cmdInfo == null) {
+			return;
+		}
+
+		Object aliasesObj = cmdInfo.get("aliases");
+		if (aliasesObj instanceof String) {
+			// plugin.yml also allows a single alias as a string
+			out.add(((String) aliasesObj).toLowerCase(Locale.ROOT));
+		} else if (aliasesObj instanceof Collection) {
+			for (Object o : (Collection<Object>) aliasesObj) {
+				if (o != null) {
+					out.add(o.toString().toLowerCase(Locale.ROOT));
+				}
+			}
+		}
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/commands/tabcompleter/AliasesTabCompleter.java

@@ -98,6 +98,13 @@ public class AliasesTabCompleter implements TabCompleter {
 		return tab;
 	}
 
+	/**
+	 * Set the command handler for this tab completer.
+	 *
+	 * @param cmd the command handler
+	 * @param adminCommand whether this is an admin command
+	 * @return this tab completer instance
+	 */
 	public AliasesTabCompleter setCMDHandle(CommandHandler cmd, boolean adminCommand) {
 		cmdHandle = cmd;
 		this.adminCommand = adminCommand;

VotingPlugin/src/main/java/com/bencodez/votingplugin/config/BungeeSettings.java

@@ -13,16 +13,11 @@ import com.bencodez.votingplugin.VotingPluginMain;
 
 import lombok.Getter;
 
+/**
+ * Configuration file for Bungee/proxy settings.
+ */
 public class BungeeSettings extends YMLFile {
 
-	@ConfigDataBoolean(path = "BungeeBroadcast")
-	@Getter
-	private boolean bungeeBroadcast = false;
-
-	@ConfigDataBoolean(path = "BungeeBroadcastAlways")
-	@Getter
-	private boolean bungeeBroadcastAlways = false;
-
 	@ConfigDataBoolean(path = "BungeeDebug")
 	@Getter
 	private boolean bungeeDebug = false;
@@ -33,32 +28,36 @@ public class BungeeSettings extends YMLFile {
 
 	@ConfigDataString(path = "Redis.Host")
 	@Getter
-	private String RedisHost = "";
+	private String redisHost = "";
 
 	@ConfigDataString(path = "Redis.Username")
 	@Getter
-	private String RedisUsername = "";
+	private String redisUsername = "";
+
+	@ConfigDataInt(path = "Redis.Db-Index")
+	@Getter
+	private int redisdbindex = 0;
 
 	@ConfigDataString(path = "PluginMessageChannel")
 	@Getter
 	private String pluginMessagingChannel = "vp:vp";
-	
+
 	@ConfigDataBoolean(path = "PluginMessageEncryption")
 	@Getter
 	private boolean pluginMessageEncryption = false;
 
 	@ConfigDataString(path = "Redis.Prefix")
 	@Getter
-	private String RedisPrefix = "";
+	private String redisPrefix = "";
 
 	@ConfigDataString(path = "Redis.Password")
 	@Getter
-	private String RedisPassword = "";
+	private String redisPassword = "";
 
 	@ConfigDataInt(path = "Redis.Port")
 	@Getter
-	private int RedisPort = 6379;
-	
+	private int redisPort = 6379;
+
 	@ConfigDataString(path = "MQTT.ClientID")
 	@Getter
 	private String mqttClientID = "";
@@ -91,10 +90,6 @@ public class BungeeSettings extends YMLFile {
 	@Getter
 	private boolean perServerPoints = false;
 
-	@ConfigDataBoolean(path = "PerServerMilestones")
-	@Getter
-	private boolean perServerMilestones = false;
-
 	@ConfigDataBoolean(path = "GiveExtraAllSitesRewards")
 	@Getter
 	private boolean giveExtraAllSitesRewards = false;
@@ -131,10 +126,6 @@ public class BungeeSettings extends YMLFile {
 	@Getter
 	private boolean votifierBypass = false;
 
-	@ConfigDataBoolean(path = "DisableBroadcast")
-	@Getter
-	private boolean disableBroadcast = false;
-
 	@ConfigDataBoolean(path = "GlobalData.UseMainMySQL")
 	@Getter
 	private boolean globlalDataUseMainMySQL = true;
@@ -147,10 +138,21 @@ public class BungeeSettings extends YMLFile {
 	@Getter
 	private ArrayList<String> bungeeVotePartyGlobalCommands = new ArrayList<>();
 
+	/**
+	 * Constructs a new BungeeSettings.
+	 *
+	 * @param plugin the main plugin instance
+	 */
 	public BungeeSettings(VotingPluginMain plugin) {
 		super(plugin, new File(plugin.getDataFolder(), "BungeeSettings.yml"));
+		setIgnoreCase(plugin.getConfigFile().isCaseInsensitiveYMLFiles());
 	}
 
+	/**
+	 * Gets the server name formatted for storage.
+	 *
+	 * @return the formatted server name
+	 */
 	public String getServerNameStorage() {
 		return getServer().replace("-", "_");
 	}

VotingPlugin/src/main/java/com/bencodez/votingplugin/config/Config.java

@@ -52,6 +52,11 @@ public class Config extends YMLFile {
 	@Getter
 	private int limitVotePoints = -1;
 
+	/** Whether YAML files should be case insensitive. */
+	@ConfigDataBoolean(path = "CaseInsensitiveYMLFiles")
+	@Getter
+	public boolean caseInsensitiveYMLFiles = false;
+
 	@ConfigDataBoolean(path = "QueueVotesDuringTimeChange")
 	@Getter
 	private boolean queueVotesDuringTimeChange = false;
@@ -76,6 +81,22 @@ public class Config extends YMLFile {
 	@Getter
 	private boolean discordSRVTopVoterAllTimeEnabled = false;
 
+	@ConfigDataBoolean(path = "DiscordSRV.TopVoter.AllTime.NewMessageOnUpdate")
+	@Getter
+	private boolean discordSRVTopVoterAllTimeNewMessageOnUpdate = false;
+
+	@ConfigDataBoolean(path = "DiscordSRV.TopVoter.Monthly.NewMessageOnUpdate")
+	@Getter
+	private boolean discordSRVTopVoterMonthlyNewMessageOnUpdate = false;
+
+	@ConfigDataBoolean(path = "DiscordSRV.TopVoter.Weekly.NewMessageOnUpdate")
+	@Getter
+	private boolean discordSRVTopVoterWeeklyNewMessageOnUpdate = false;
+
+	@ConfigDataBoolean(path = "DiscordSRV.TopVoter.Daily.NewMessageOnUpdate")
+	@Getter
+	private boolean discordSRVTopVoterDailyNewMessageOnUpdate = false;
+
 	@ConfigDataLong(path = "DiscordSRV.TopVoter.AllTime.Channel")
 	@Getter
 	private long discordSRVTopVoterAllTimeChannel = 0;
@@ -86,7 +107,7 @@ public class Config extends YMLFile {
 
 	@ConfigDataString(path = "DiscordSRV.TopVoter.AllTime.RankDisplay")
 	@Getter
-	private String discordSRVTopVoterAllTimeRankDisplay = "%rank%: &6%player% - %votes% Votes";
+	private String discordSRVTopVoterAllTimeRankDisplay = "%rank%: %player% - %votes% Votes";
 
 	@ConfigDataBoolean(path = "DiscordSRV.TopVoter.Monthly.Enabled")
 	@Getter
@@ -102,7 +123,7 @@ public class Config extends YMLFile {
 
 	@ConfigDataString(path = "DiscordSRV.TopVoter.Monthly.RankDisplay")
 	@Getter
-	private String discordSRVTopVoterMonthlyRankDisplay = "%rank%: &6%player% - %votes% Votes";
+	private String discordSRVTopVoterMonthlyRankDisplay = "%rank%: %player% - %votes% Votes";
 
 	@ConfigDataBoolean(path = "DiscordSRV.TopVoter.Weekly.Enabled")
 	@Getter
@@ -118,7 +139,7 @@ public class Config extends YMLFile {
 
 	@ConfigDataString(path = "DiscordSRV.TopVoter.Weekly.RankDisplay")
 	@Getter
-	private String discordSRVTopVoterWeeklyRankDisplay = "%rank%: &6%player% - %votes% Votes";
+	private String discordSRVTopVoterWeeklyRankDisplay = "%rank%: %player% - %votes% Votes";
 
 	@ConfigDataBoolean(path = "DiscordSRV.TopVoter.Daily.Enabled")
 	@Getter
@@ -134,8 +155,39 @@ public class Config extends YMLFile {
 
 	@ConfigDataString(path = "DiscordSRV.TopVoter.Daily.RankDisplay")
 	@Getter
-	private String discordSRVTopVoterDailyRankDisplay = "%rank%: &6%player% - %votes% Votes";
+	private String discordSRVTopVoterDailyRankDisplay = "%rank%: %player% - %votes% Votes";
 
+	// VoteLogging configuration section - minimal options mirror Config.yml
+	@ConfigDataBoolean(path = "VoteLogging.Enabled")
+	@Getter
+	private boolean voteLoggingEnabled = false;
+
+	@ConfigDataInt(path = "VoteLogging.PurgeDays")
+	@Getter
+	private int voteLoggingPurgeDays = 30;
+
+	@ConfigDataBoolean(path = "VoteLogging.UseMainMySQL")
+	@Getter
+	private boolean voteLoggingUseMainMySQL = true;
+
+	/**
+	 * Gets the vote logging configuration section.
+	 *
+	 * @return the vote logging configuration section
+	 */
+	public ConfigurationSection getVoteLoggingSection() {
+		if (!getData().isConfigurationSection("VoteLogging")) {
+			getData().createSection("VoteLogging");
+		}
+		return getData().getConfigurationSection("VoteLogging");
+	}
+
+	/**
+	 * Checks if DiscordSRV top voter is enabled.
+	 *
+	 * @param topVoter the top voter type
+	 * @return true if enabled
+	 */
 	public boolean isDiscordSRVTopVoterEnabled(TopVoter topVoter) {
 		switch (topVoter) {
 		case AllTime:
@@ -151,6 +203,33 @@ public class Config extends YMLFile {
 		}
 	}
 
+	/**
+	 * Checks if DiscordSRV top voter should send a new message on update.
+	 *
+	 * @param topVoter the top voter type
+	 * @return true if new message should be sent
+	 */
+	public boolean isDiscordSRVTopVoterNewMessageOnUpdate(TopVoter topVoter) {
+		switch (topVoter) {
+		case AllTime:
+			return isDiscordSRVTopVoterAllTimeNewMessageOnUpdate();
+		case Monthly:
+			return isDiscordSRVTopVoterMonthlyNewMessageOnUpdate();
+		case Weekly:
+			return isDiscordSRVTopVoterWeeklyNewMessageOnUpdate();
+		case Daily:
+			return isDiscordSRVTopVoterDailyNewMessageOnUpdate();
+		default:
+			return false;
+		}
+	}
+
+	/**
+	 * Gets the DiscordSRV top voter channel ID.
+	 *
+	 * @param topVoter the top voter type
+	 * @return the channel ID
+	 */
 	public long getDiscordSRVTopVoterChannel(TopVoter topVoter) {
 		switch (topVoter) {
 		case AllTime:
@@ -166,6 +245,12 @@ public class Config extends YMLFile {
 		}
 	}
 
+	/**
+	 * Gets the DiscordSRV top voter title.
+	 *
+	 * @param topVoter the top voter type
+	 * @return the title
+	 */
 	public String getDiscordSRVTopVoterTitle(TopVoter topVoter) {
 		switch (topVoter) {
 		case AllTime:
@@ -181,6 +266,12 @@ public class Config extends YMLFile {
 		}
 	}
 
+	/**
+	 * Gets the DiscordSRV top voter rank display format.
+	 *
+	 * @param topVoter the top voter type
+	 * @return the rank display format
+	 */
 	public String getDiscordSRVTopVoterRankDisplay(TopVoter topVoter) {
 		switch (topVoter) {
 		case AllTime:
@@ -216,10 +307,6 @@ public class Config extends YMLFile {
 	@Getter
 	private boolean extraVoteShopCheck = true;
 
-	@ConfigDataBoolean(path = "TrackShopPurchases")
-	@Getter
-	private boolean trackShopPurchases = false;
-
 	@ConfigDataBoolean(path = "AlwaysUpdate")
 	@Getter
 	private boolean alwaysUpdate = false;
@@ -228,26 +315,18 @@ public class Config extends YMLFile {
 	@Getter
 	private boolean autoCreateVoteSites = true;
 
-	@ConfigDataBoolean(path = "Format.BroadcastVote")
-	@Getter
-	private boolean broadcastVotesEnabled = true;
-
 	@ConfigDataBoolean(path = "CountFakeVotes")
 	@Getter
 	private boolean countFakeVotes = true;
 
-	@ConfigDataInt(path = "DelayBetweenUpdates")
+	@ConfigDataString(path = "DelayBetweenUpdates")
 	@Getter
-	private int delayBetweenUpdates = 3;
+	private String delayBetweenUpdates = "3m";
 
 	@ConfigDataBoolean(path = "DisableAdvancedTab")
 	@Getter
 	private boolean disableAdvancedTab = false;
 
-	@ConfigDataBoolean(path = "DisableActionBar")
-	@Getter
-	private boolean disableActionBar = false;
-
 	@ConfigDataBoolean(path = "DisableCoolDownCheck")
 	@Getter
 	private boolean disableCoolDownCheck = false;
@@ -272,6 +351,14 @@ public class Config extends YMLFile {
 	@Getter
 	private boolean disableNoServiceSiteMessage = false;
 
+	@ConfigDataString(path = "Format.Commands.AdminVote.Points.PlayerRemoved")
+	@Getter
+	private String formatCommandsAdminVotePointsPlayerRemoved = "&c%amount% voting points have been removed from you";
+
+	@ConfigDataString(path = "Format.Commands.AdminVote.Points.PlayerGiven")
+	@Getter
+	private String formatCommandsAdminVotePointsPlayerGiven = "&cYou have been given %amount% voting points";
+
 	@ConfigDataBoolean(path = "DisableUpdateChecking")
 	@Getter
 	private boolean disableUpdateChecking = false;
@@ -288,29 +375,9 @@ public class Config extends YMLFile {
 	@Getter
 	private boolean extraBackgroundUpdate = false;
 
-	@ConfigDataString(path = "Format.AlternateBroadcast.Broadcast")
-	@Getter
-	private String formatAlternateBroadcastBroadcast = "&6[&4Broadcast&6] &2%numberofplayers% voted in the last half hour! /vote";
-
-	@ConfigDataInt(path = "Format.AlternateBroadcast.Delay")
-	@Getter
-	private int formatAlternateBroadcastDelay = 30;
-
-	@ConfigDataBoolean(path = "Format.AlternateBroadcast.Enabled")
-	@Getter
-	private boolean formatAlternateBroadcastEnabled = false;
-
-	@ConfigDataBoolean(path = "Format.OnlyOneOfflineBroadcast")
-	@Getter
-	private boolean formatOnlyOneOfflineBroadcast = false;
-
-	@ConfigDataString(path = "Format.OfflineBroadcast")
-	@Getter
-	private String formatOfflineBroadcast = "&6[&4Broadcast&6] &2Thanks &c%player% &2for voting on %numberofvotes% times!";
-
 	@ConfigDataBoolean(path = "Format.Commands.Vote.ForceLinks")
 	@Getter
-	private boolean formatCommandsVoteForceLinks = false;
+	private boolean formatCommandsVoteForceLinks = true;
 
 	@ConfigDataString(path = "Format.Commands.Vote.Last.LastVoted")
 	@Getter
@@ -420,10 +487,6 @@ public class Config extends YMLFile {
 	@Getter
 	private boolean loadCommandAliases = true;
 
-	@ConfigDataBoolean(path = "LogVotesToFile")
-	@Getter
-	private boolean logVotesToFile = false;
-
 	@ConfigDataInt(path = "MaxiumNumberOfTopVotersToLoad")
 	@Getter
 	private int MaxiumNumberOfTopVotersToLoad = 1000;
@@ -456,10 +519,6 @@ public class Config extends YMLFile {
 	@Getter
 	private boolean useJavascriptPlaceholders = false;
 
-	@ConfigDataBoolean(path = "UsePrimaryAccountForPlaceholders")
-	@Getter
-	private boolean usePrimaryAccountForPlaceholders = false;
-
 	@ConfigDataBoolean(path = "UseVoteGUIMainCommand")
 	@Getter
 	private boolean useVoteGUIMainCommand = false;
@@ -480,14 +539,6 @@ public class Config extends YMLFile {
 	@Getter
 	private Set<String> customPlaceholderReturns = new HashSet<>();
 
-	@ConfigDataString(path = "Format.BroadcastMsg")
-	@Getter
-	private String formatBroadCastMsg = "&6[&4Broadcast&6] &2Thanks &c%player% &2for voting on %SiteName%";
-
-	@ConfigDataBoolean(path = "Format.BroadcastWhenOnline")
-	@Getter
-	private boolean formatBroadcastWhenOnline = false;
-
 	@ConfigDataBoolean(path = "Format.Commands.Vote.AutoInputSites")
 	@Getter
 	private boolean formatCommandsVoteAutoInputSites = true;
@@ -714,28 +765,22 @@ public class Config extends YMLFile {
 	@Getter
 	private boolean topVoterIgnorePermission = false;
 
-	@ConfigDataBoolean(path = "VoteReminding.Enabled")
-	@Getter
-	private boolean voteRemindingEnabled = true;
-
-	@ConfigDataInt(path = "VoteReminding.RemindDelay")
-	@Getter
-	private int voteRemindingRemindDelay = 30;
-
-	@ConfigDataBoolean(path = "VoteReminding.RemindOnLogin")
-	@Getter
-	private boolean voteRemindingRemindOnLogin = false;
-
-	@ConfigDataBoolean(path = "VoteReminding.RemindOnlyOnce")
-	@Getter
-	private boolean voteRemindingRemindOnlyOnce = false;
-
 	@ConfigDataString(path = "VoteTopDefault")
 	@Getter
 	private String voteTopDefault = "Monthly";
 
+	@ConfigDataBoolean(path = "AlwaysProcessAsyncPlaceholders")
+	@Getter
+	private boolean alwaysProcessAsyncPlaceholders = false;
+
+	/**
+	 * Constructs a new Config.
+	 *
+	 * @param plugin the main plugin instance
+	 */
 	public Config(VotingPluginMain plugin) {
 		super(plugin, new File(plugin.getDataFolder(), "Config.yml"));
+		setIgnoreCase(true);
 	}
 
 	/**
@@ -748,10 +793,22 @@ public class Config extends YMLFile {
 		return (ArrayList<String>) getData().getList("BlackList", new ArrayList<>());
 	}
 
+	/**
+	 * Gets the custom commands configuration section.
+	 *
+	 * @param ident the command identifier
+	 * @return the configuration section
+	 */
 	public ConfigurationSection getCustomCommands(String ident) {
 		return getData().getConfigurationSection("CustomCommands." + ident);
 	}
 
+	/**
+	 * Gets the custom placeholder return keys.
+	 *
+	 * @param placeholder the placeholder name
+	 * @return set of return keys
+	 */
 	public Set<String> getCustomPlaceholderReturns(String placeholder) {
 		Set<String> str = getData().getConfigurationSection("CustomPlaceholderReturns." + placeholder).getKeys(false);
 		if (str == null) {
@@ -760,6 +817,13 @@ public class Config extends YMLFile {
 		return str;
 	}
 
+	/**
+	 * Gets a custom placeholder return value.
+	 *
+	 * @param placeholder the placeholder name
+	 * @param returnString the return key
+	 * @return the return value
+	 */
 	public String getCustomPlaceholderReturns(String placeholder, String returnString) {
 		return getData().getString("CustomPlaceholderReturns." + placeholder + "." + returnString, "");
 	}
@@ -777,6 +841,11 @@ public class Config extends YMLFile {
 
 	}
 
+	/**
+	 * Gets the vote streak lines format.
+	 *
+	 * @return list of format lines
+	 */
 	@SuppressWarnings("unchecked")
 	public ArrayList<String> getFormatCommandsVoteStreakLines() {
 		return (ArrayList<String>) getData().getList("Format.Commands.Vote.Streak.Lines", new ArrayList<>());
@@ -794,6 +863,11 @@ public class Config extends YMLFile {
 		return (ArrayList<String>) getData().getList("Format.Commands.Vote.Text", str);
 	}
 
+	/**
+	 * Gets the vote total format lines.
+	 *
+	 * @return list of format lines
+	 */
 	@SuppressWarnings("unchecked")
 	public ArrayList<String> getFormatCommandsVoteTotal() {
 		ArrayList<String> list = (ArrayList<String>) getData().getList("Format.Commands.Vote.Total", new ArrayList<>());
@@ -807,6 +881,11 @@ public class Config extends YMLFile {
 		return list;
 	}
 
+	/**
+	 * Gets the vote total all format lines.
+	 *
+	 * @return list of format lines
+	 */
 	@SuppressWarnings("unchecked")
 	public ArrayList<String> getFormatCommandsVoteTotalAll() {
 
@@ -832,6 +911,12 @@ public class Config extends YMLFile {
 		return (ArrayList<String>) getData().getList("Format.Commands.Vote.Help.Lines", new ArrayList<>());
 	}
 
+	/**
+	 * Checks if a top voter type should be loaded.
+	 *
+	 * @param top the top voter type
+	 * @return true if should be loaded
+	 */
 	public boolean getLoadTopVoter(TopVoter top) {
 		switch (top) {
 		case AllTime:
@@ -847,19 +932,15 @@ public class Config extends YMLFile {
 		}
 	}
 
+	/**
+	 * Gets the placeholder cache level.
+	 *
+	 * @return the cache level
+	 */
 	public PlaceholderCacheLevel getPlaceholderCacheLevel() {
 		return PlaceholderCacheLevel.getCache(getPlaceholderCacheLevelString());
 	}
 
-	/**
-	 * Gets the rewards.
-	 *
-	 * @return the rewards
-	 */
-	public String getVoteRemindingRewardsPath() {
-		return "VoteReminding.Rewards";
-	}
-
 	@Override
 	public void loadValues() {
 		new AnnotationHandler().load(getData(), this);

VotingPlugin/src/main/java/com/bencodez/votingplugin/config/ConfigVoteSites.java

@@ -5,8 +5,10 @@ import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.Comparator;
+import java.util.concurrent.TimeUnit;
 
 import org.bukkit.Bukkit;
+import org.bukkit.ChatColor;
 import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.configuration.file.FileConfiguration;
 import org.bukkit.configuration.file.YamlConfiguration;
@@ -16,8 +18,9 @@ import com.bencodez.advancedcore.api.rewards.DirectlyDefinedReward;
 import com.bencodez.simpleapi.array.ArrayUtils;
 import com.bencodez.simpleapi.file.YMLFile;
 import com.bencodez.simpleapi.messages.MessageAPI;
+import com.bencodez.simpleapi.time.ParsedDuration;
 import com.bencodez.votingplugin.VotingPluginMain;
-import com.bencodez.votingplugin.objects.VoteSite;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
 // TODO: Auto-generated Javadoc
 /**
@@ -27,8 +30,14 @@ public class ConfigVoteSites extends YMLFile {
 
 	private VotingPluginMain plugin;
 
+	/**
+	 * Constructs a new ConfigVoteSites.
+	 *
+	 * @param plugin the plugin instance
+	 */
 	public ConfigVoteSites(VotingPluginMain plugin) {
 		super(plugin, new File(plugin.getDataFolder(), "VoteSites.yml"));
+		setIgnoreCase(plugin.getConfigFile().isCaseInsensitiveYMLFiles());
 		this.plugin = plugin;
 	}
 
@@ -40,13 +49,14 @@ public class ConfigVoteSites extends YMLFile {
 	public void generateVoteSite(String siteName) {
 		if (plugin.getConfigFile().isAutoCreateVoteSites()) {
 			String org = siteName;
-			siteName = siteName.replace(".", "_").replace(" ", "_");
+			siteName = siteName.replaceAll("[\\.\\s]+", "_");
+
 			plugin.getLogger().warning("VoteSite " + siteName + " does not exist with the servicesite '" + org
 					+ "', creating one, set AutoCreateVoteSites to false to prevent this");
 			setEnabled(siteName, true);
 			setServiceSite(siteName, org);
 			setVoteURL(siteName, "VoteURL");
-			setVoteDelay(siteName, 24);
+			setVoteDelay(siteName, "24h");
 			set(siteName, "DisplayItem.Material", "STONE");
 			set(siteName, "DisplayItem.Amount", 1);
 			set(siteName, "Rewards.Messages.Player", "&aThanks for voting on %ServiceSite%!");
@@ -122,14 +132,31 @@ public class ConfigVoteSites extends YMLFile {
 		return getData().getConfigurationSection("VoteSites." + siteName);
 	}
 
+	/**
+	 * Gets the display name for a site.
+	 *
+	 * @param site the site name
+	 * @return the display name
+	 */
 	public String getDisplayName(String site) {
 		return getData(site).getString("Name");
 	}
 
+	/**
+	 * Gets the path to the every site reward.
+	 *
+	 * @return the every site reward path
+	 */
 	public String getEverySiteRewardPath() {
 		return "EverySiteReward";
 	}
 
+	/**
+	 * Gets the item configuration for a site.
+	 *
+	 * @param site the site name
+	 * @return the item configuration
+	 */
 	public ConfigurationSection getItem(String site) {
 		if (getData(site).isConfigurationSection("DisplayItem")) {
 			return getData(site).getConfigurationSection("DisplayItem");
@@ -137,6 +164,12 @@ public class ConfigVoteSites extends YMLFile {
 		return getData(site).getConfigurationSection("Item");
 	}
 
+	/**
+	 * Gets the permission required to view a site.
+	 *
+	 * @param siteName the site name
+	 * @return the permission to view
+	 */
 	public String getPermissionToView(String siteName) {
 		return getData(siteName).getString("PermissionToView", "");
 	}
@@ -172,23 +205,38 @@ public class ConfigVoteSites extends YMLFile {
 	}
 
 	/**
-	 * Gets the vote delay.
+	 * Gets the vote delay for a site.
 	 *
-	 * @param siteName the site name
+	 * @param site the site name
 	 * @return the vote delay
 	 */
-	public double getVoteDelay(String siteName) {
-		return getData(siteName).getDouble("VoteDelay", 24);
+	public ParsedDuration getVoteDelay(String site) {
+		ConfigurationSection sec = getData(site);
+
+		// NEW FORMAT (string)
+		if (sec.isString("VoteDelay")) {
+			return ParsedDuration.parse(sec.getString("VoteDelay"), TimeUnit.HOURS);
+		}
+
+		// LEGACY FORMAT (numbers)
+		double hours = sec.getDouble("VoteDelay", 0);
+		double minutes = sec.getDouble("VoteDelayMin", 0);
+
+		long millis = (long) (hours * 60 * 60 * 1000) + (long) (minutes * 60 * 1000);
+
+		return ParsedDuration.ofMillis(millis);
 	}
 
+	/**
+	 * Gets the vote delay daily hour for a site.
+	 *
+	 * @param siteName the site name
+	 * @return the vote delay daily hour
+	 */
 	public int getVoteDelayDailyHour(String siteName) {
 		return getData(siteName).getInt("VoteDelayDailyHour", 0);
 	}
 
-	public double getVoteDelayMin(String siteName) {
-		return getData(siteName).getDouble("VoteDelayMin", 0);
-	}
-
 	/**
 	 * Gets the vote site enabled.
 	 *
@@ -212,7 +260,7 @@ public class ConfigVoteSites extends YMLFile {
 			try {
 				data.save(dFile);
 			} catch (IOException e) {
-				plugin.getLogger().severe("Could not create VoteSites/" + siteName + ".yml!");
+				plugin.getLogger().severe(ChatColor.RED + "Could not create VoteSites/" + siteName + ".yml!");
 
 			}
 		}
@@ -220,18 +268,42 @@ public class ConfigVoteSites extends YMLFile {
 
 	}
 
+	/**
+	 * Gets whether to give rewards offline for a site.
+	 *
+	 * @param site the site name
+	 * @return true if rewards should be given offline
+	 */
 	public boolean getVoteSiteGiveOffline(String site) {
 		return getData(site).getBoolean("ForceOffline", getData(site).getBoolean("GiveOffline"));
 	}
 
+	/**
+	 * Gets whether a site is hidden.
+	 *
+	 * @param siteName the site name
+	 * @return true if the site is hidden
+	 */
 	public boolean getVoteSiteHidden(String siteName) {
 		return getData(siteName).getBoolean("Hidden");
 	}
 
+	/**
+	 * Gets whether to ignore can vote check for a site.
+	 *
+	 * @param siteName the site name
+	 * @return true if can vote check should be ignored
+	 */
 	public boolean getVoteSiteIgnoreCanVote(String siteName) {
 		return getData(siteName).getBoolean("IgnoreCanVote");
 	}
 
+	/**
+	 * Gets whether vote delay resets daily for a site.
+	 *
+	 * @param siteName the site name
+	 * @return true if vote delay resets daily
+	 */
 	public boolean getVoteSiteResetVoteDelayDaily(String siteName) {
 		return getData(siteName).getBoolean("VoteDelayDaily");
 	}
@@ -278,24 +350,35 @@ public class ConfigVoteSites extends YMLFile {
 		return voteSites;
 	}
 
+	/**
+	 * Gets the names of vote sites.
+	 *
+	 * @param checkEnabled whether to check if sites are enabled
+	 * @return the list of vote site names
+	 */
 	public ArrayList<String> getVoteSitesNames(boolean checkEnabled) {
 		ArrayList<String> siteNames = new ArrayList<>();
-		if (getData().isConfigurationSection("VoteSites")) {
-			siteNames = ArrayUtils.convert(getData().getConfigurationSection("VoteSites").getKeys(false));
+
+		if (!getData().isConfigurationSection("VoteSites")) {
+			return siteNames;
 		}
 
+		siteNames = ArrayUtils.convert(getData().getConfigurationSection("VoteSites").getKeys(false));
+
 		for (int i = siteNames.size() - 1; i >= 0; i--) {
-			// plugin.getLogger().info(siteNames.get(i));
-			if (!getData().isConfigurationSection("VoteSites." + siteNames.get(i))) {
-				plugin.getLogger()
-						.warning("VoteSites." + siteNames.get(i) + " is not a configuration section, please remove");
-				siteNames.remove(i);
-			} else if (siteNames.get(i).equalsIgnoreCase("null")
-					|| (!getVoteSiteEnabled(siteNames.get(i)) && checkEnabled) || !siteCheck(siteNames.get(i))) {
-				// plugin.getLogger().info("Removed: " + siteNames.get(i));
+			String site = siteNames.get(i);
+			String path = "VoteSites." + site;
+
+			if (!getData().isConfigurationSection(path)) {
+				plugin.getLogger().warning(path + " is not a configuration section, please remove");
 				siteNames.remove(i);
+				continue;
 			}
 
+			if (site.equalsIgnoreCase("null") || (!getVoteSiteEnabled(site) && checkEnabled) || !siteCheck(site)) {
+				siteNames.remove(i);
+				continue;
+			}
 		}
 
 		return siteNames;
@@ -311,6 +394,12 @@ public class ConfigVoteSites extends YMLFile {
 		return getData(siteName).getString("VoteURL", "");
 	}
 
+	/**
+	 * Gets whether to wait until vote delay for a site.
+	 *
+	 * @param siteName the site name
+	 * @return true if should wait until vote delay
+	 */
 	public boolean getWaitUntilVoteDelay(String siteName) {
 		return getData(siteName).getBoolean("WaitUntilVoteDelay", false);
 	}
@@ -387,10 +476,22 @@ public class ConfigVoteSites extends YMLFile {
 		set(siteName, "Cumulative.Rewards", value);
 	}
 
+	/**
+	 * Sets the cumulative votes for a site.
+	 *
+	 * @param siteName the site name
+	 * @param value    the value
+	 */
 	public void setCumulativeVotes(String siteName, int value) {
 		set(siteName, "Cumulative.Votes", value);
 	}
 
+	/**
+	 * Sets the display name for a site.
+	 *
+	 * @param siteName the site name
+	 * @param value    the value
+	 */
 	public void setDisplayName(String siteName, String value) {
 		set(siteName, "Name", value);
 	}
@@ -405,6 +506,12 @@ public class ConfigVoteSites extends YMLFile {
 		set(siteName, "Enabled", disabled);
 	}
 
+	/**
+	 * Sets whether to force offline for a site.
+	 *
+	 * @param siteName the site name
+	 * @param value    the value
+	 */
 	public void setForceOffline(String siteName, boolean value) {
 		set(siteName, "ForceOffline", value);
 
@@ -446,14 +553,10 @@ public class ConfigVoteSites extends YMLFile {
 	 * @param siteName  the site name
 	 * @param voteDelay the vote delay
 	 */
-	public void setVoteDelay(String siteName, double voteDelay) {
+	public void setVoteDelay(String siteName, String voteDelay) {
 		set(siteName, "VoteDelay", voteDelay);
 	}
 
-	public void setVoteDelayDaily(String siteName, boolean value) {
-		set(siteName, "VoteDelayDaily", value);
-	}
-
 	/**
 	 * Sets the vote URL.
 	 *
@@ -482,4 +585,24 @@ public class ConfigVoteSites extends YMLFile {
 		return pass;
 	}
 
+	/**
+	 * Sets the vote delay daily hour for a site.
+	 *
+	 * @param siteName the site name
+	 * @param intValue the value
+	 */
+	public void setVoteDelayDailyHour(String siteName, int intValue) {
+		set(siteName, "VoteDelayDailyHour", intValue);
+	}
+
+	/**
+	 * Sets whether vote delay is daily for a site.
+	 *
+	 * @param siteName the site name
+	 * @param value    the value
+	 */
+	public void setVoteDelayDaily(String siteName, boolean value) {
+		set(siteName, "VoteDelayDaily", value);
+	}
+
 }

VotingPlugin/src/main/java/com/bencodez/votingplugin/config/GUI.java

@@ -21,6 +21,9 @@ import com.bencodez.votingplugin.topvoter.TopVoter;
 
 import lombok.Getter;
 
+/**
+ * GUI configuration.
+ */
 public class GUI extends YMLFile {
 
 	@ConfigDataString(path = "BOOK.VoteURLBookGUI.AlreadyVotedColor")
@@ -88,42 +91,42 @@ public class GUI extends YMLFile {
 	@Getter
 	private boolean chestVoteURLAllUrlsButtonrequireAllSitesVoted = true;
 
-	@ConfigDataString(path = "GUIMethod.Best")
-	@Getter
-	private String guiMethodBest = "CHEST";
-
-	@ConfigDataString(path = "GUIMethod.GUI")
-	@Getter
-	private String guiMethodGUI = "CHEST";
-
-	@ConfigDataString(path = "GUIMethod.Last")
-	@Getter
-	private String guiMethodLast = "CHEST";
-
-	@ConfigDataString(path = "GUIMethod.Next")
-	@Getter
-	private String guiMethodNext = "CHEST";
-
-	@ConfigDataString(path = "GUIMethod.Streak")
-	@Getter
-	private String guiMethodStreak = "CHEST";
-
-	@ConfigDataString(path = "GUIMethod.Today")
+	@ConfigDataString(path = "GUIMethod.Today", options = { "CHEST", "CHAT", "DIALOG" })
 	@Getter
 	private String guiMethodToday = "CHEST";
 
-	@ConfigDataString(path = "GUIMethod.TopVoter")
+	@ConfigDataString(path = "GUIMethod.TopVoter", options = { "CHEST", "CHAT", "DIALOG" })
 	@Getter
 	private String guiMethodTopVoter = "CHEST";
 
-	@ConfigDataString(path = "GUIMethod.Total")
+	@ConfigDataString(path = "GUIMethod.Last", options = { "CHEST", "CHAT", "DIALOG" })
+	@Getter
+	private String guiMethodLast = "CHEST";
+
+	@ConfigDataString(path = "GUIMethod.Next", options = { "CHEST", "CHAT", "BOOK", "DIALOG" })
+	@Getter
+	private String guiMethodNext = "CHEST";
+
+	@ConfigDataString(path = "GUIMethod.Total", options = { "CHEST", "CHAT", "DIALOG" })
 	@Getter
 	private String guiMethodTotal = "CHEST";
 
-	@ConfigDataString(path = "GUIMethod.URL")
+	@ConfigDataString(path = "GUIMethod.URL", options = { "CHEST", "CHAT", "BOOK", "DIALOG" })
 	@Getter
 	private String guiMethodURL = "CHEST";
 
+	@ConfigDataString(path = "GUIMethod.Best", options = { "CHEST", "CHAT", "DIALOG" })
+	@Getter
+	private String guiMethodBest = "CHEST";
+
+	@ConfigDataString(path = "GUIMethod.Streak", options = { "CHEST", "CHAT", "DIALOG" })
+	@Getter
+	private String guiMethodStreak = "CHEST";
+
+	@ConfigDataString(path = "GUIMethod.GUI", options = { "CHEST", "DIALOG" })
+	@Getter
+	private String guiMethodGUI = "CHEST";
+
 	@ConfigDataBoolean(path = "LastMonthGUI")
 	@Getter
 	private boolean lastMonthGUI = false;
@@ -352,17 +355,29 @@ public class GUI extends YMLFile {
 
 	@ConfigDataString(path = "CHEST.VoteURL.URLText")
 	@Getter
-	private String chestVoteURLURLText = "&3&lVote at &b&l[Text=\"&b&l%VoteUrl%\",hover=\"&aClick to open %sitename%\",url=\"%VoteUrl%\"]";
+	private String chestVoteURLURLText = "%VoteUrl%";
 
 	@ConfigDataBoolean(path = "CHEST.VoteURL.ViewAllUrlsButtonEnabled")
 	@Getter
 	private boolean chestVoteURLViewAllUrlsButtonEnabled = false;
 
+	/**
+	 * Constructs a new GUI configuration.
+	 *
+	 * @param plugin the plugin instance
+	 */
 	public GUI(VotingPluginMain plugin) {
 		super(plugin, new File(plugin.getDataFolder(), "GUI.yml"));
+		setIgnoreCase(plugin.getConfigFile().isCaseInsensitiveYMLFiles());
 		this.plugin = plugin;
 	}
 
+	/**
+	 * Gets the extra items for a chest GUI.
+	 *
+	 * @param gui the GUI name
+	 * @return the extra items
+	 */
 	public Set<String> getChestGUIExtraItems(String gui) {
 		if (getData().isConfigurationSection("CHEST." + gui + ".ExtraItems")) {
 			return getData().getConfigurationSection("CHEST." + gui + ".ExtraItems").getKeys(false);
@@ -370,6 +385,13 @@ public class GUI extends YMLFile {
 		return new HashSet<>();
 	}
 
+	/**
+	 * Gets an extra item configuration for a chest GUI.
+	 *
+	 * @param gui  the GUI name
+	 * @param item the item name
+	 * @return the item configuration
+	 */
 	public ConfigurationSection getChestGUIExtraItemsItem(String gui, String item) {
 		return getData().getConfigurationSection("CHEST." + gui + ".ExtraItems." + item);
 	}
@@ -396,10 +418,23 @@ public class GUI extends YMLFile {
 		return (ArrayList<String>) getData().getList("CHEST.VoteGUI." + slot + ".Item.Lore", new ArrayList<>());
 	}
 
+	/**
+	 * Gets the rewards path for a chest vote GUI slot.
+	 *
+	 * @param slot     the slot
+	 * @param lastPath the last path segment
+	 * @return the rewards path
+	 */
 	public String getChestVoteGUISlotRewardsPath(String slot, String lastPath) {
 		return "CHEST.VoteGUI." + slot + "." + lastPath;
 	}
 
+	/**
+	 * Gets the configuration section for a chest vote GUI slot.
+	 *
+	 * @param slot the slot
+	 * @return the configuration section
+	 */
 	public ConfigurationSection getChestVoteGUISlotSection(String slot) {
 		return getData().getConfigurationSection("CHEST.VoteGUI." + slot + ".Item");
 	}
@@ -414,10 +449,22 @@ public class GUI extends YMLFile {
 		return getData().getInt("CHEST.VoteGUI." + slot + ".Slot", -1);
 	}
 
+	/**
+	 * Gets the custom site name display for a vote next GUI.
+	 *
+	 * @param site the site name
+	 * @return the custom display name
+	 */
 	public String getChestVoteNextCustomSiteNamesDisplays(String site) {
 		return getData().getString("CHEST.VoteNext.CustomSiteNamesDisplays." + site, "");
 	}
 
+	/**
+	 * Gets the total item configuration for a top voter.
+	 *
+	 * @param top the top voter
+	 * @return the item configuration
+	 */
 	public ConfigurationSection getChestVoteTotalItem(TopVoter top) {
 		switch (top) {
 		case AllTime:
@@ -434,6 +481,12 @@ public class GUI extends YMLFile {
 		}
 	}
 
+	/**
+	 * Gets an extra item configuration for a vote URL GUI.
+	 *
+	 * @param item the item name
+	 * @return the item configuration
+	 */
 	public ConfigurationSection getChestVoteURLExtraItemsItem(String item) {
 		return getData().getConfigurationSection("CHEST.VoteURL.ExtraItems." + item);
 	}

VotingPlugin/src/main/java/com/bencodez/votingplugin/config/ShopFile.java

@@ -15,66 +15,71 @@ import com.bencodez.simpleapi.file.annotation.ConfigDataString;
 import com.bencodez.votingplugin.VotingPluginMain;
 
 import lombok.Getter;
+import lombok.Setter;
 
+/**
+ * The ShopFile class manages the vote shop configuration.
+ */
+@Getter
+@Setter
 public class ShopFile extends YMLFile {
 
-	@Getter
 	@ConfigDataConfigurationSection(path = "ShopConfirmPurchase.NoItem")
 	private ConfigurationSection shopConfirmPurchaseNoItem;
 
-	@Getter
+	@ConfigDataBoolean(path = "ShopConfirmPurchase.UseDialog")
+	private boolean shopConfirmPurchaseUseDialog = false;
+
 	@ConfigDataString(path = "ShopConfirmPurchase.Title")
 	private String shopConfirmPurchaseTitle = "Confirm Purchase?";
 
-	@Getter
 	@ConfigDataConfigurationSection(path = "ShopConfirmPurchase.YesItem")
 	private ConfigurationSection shopConfirmPurchaseYesItem;
 
-	@Getter
 	@ConfigDataString(path = "VoteShop.Disabled")
 	private String voteShopDisabled = "&cVote shop disabled";
 
 	@ConfigDataBoolean(path = "VoteShop.HideLimitedReached")
-	@Getter
 	private boolean voteShopHideLimitedReached = true;
 
 	@ConfigDataString(path = "VoteShop.LimitReached")
-	@Getter
 	private String voteShopLimitReached = "&aYou reached your limit";
 
 	@ConfigDataBoolean(path = "VoteShop.RequireConfirmation")
-	@Getter
 	private boolean voteShopRequireConfirmation = false;
 
 	private VotingPluginMain plugin;
 
 	@ConfigDataBoolean(path = "VoteShop.BackButton")
-	@Getter
 	private boolean voteShopBackButton = true;
 
 	@ConfigDataBoolean(path = "VoteShop.ReopenGUIOnPurchase")
-	@Getter
-	private boolean voteShopReopenGUIOnPurchase = true;
+	private boolean voteShopReopenGuiOnPurchase = true;
 
 	@ConfigDataBoolean(path = "VoteShop.Enabled")
-	@Getter
 	private boolean voteShopEnabled = true;
 
 	@ConfigDataString(path = "VoteShop.Name")
-	@Getter
 	private String voteShopName = "VoteShop";
 
 	@ConfigDataKeys(path = "ExtraItems")
-	@Getter
-	private Set<String> voteShopExtraItems = new HashSet<>();
+	private Set<String> voteShopExtraItems = new HashSet<String>();
 
+	/**
+	 * Constructs a new ShopFile.
+	 *
+	 * @param plugin the main plugin instance
+	 */
 	public ShopFile(VotingPluginMain plugin) {
 		super(plugin, new File(plugin.getDataFolder(), "Shop.yml"));
+		setIgnoreCase(plugin.getConfigFile().isCaseInsensitiveYMLFiles());
 		this.plugin = plugin;
 	}
 
+	/**
+	 * Converts vote shop data from the GUI file to this shop file.
+	 */
 	public void convertFromGUIFile() {
-		// booleans
 		setValue("VoteShop.Enabled", plugin.getGui().getData().getBoolean("CHEST.VoteShopEnabled"));
 		setValue("VoteShop.BackButton", plugin.getGui().getData().getBoolean("CHEST.VoteShopBackButton"));
 		setValue("VoteShop.HideLimitReached", plugin.getGui().getData().getBoolean("CHEST.VoteShopHideLimitedReached"));
@@ -82,20 +87,20 @@ public class ShopFile extends YMLFile {
 				plugin.getGui().getData().getBoolean("CHEST.VoteShopRequireConfirmation"));
 		setValue("VoteShop.ReopenGUIOnPurchase",
 				plugin.getGui().getData().getBoolean("CHEST.VoteShopReopenGUIOnPurchase"));
-
-		// strings
 		setValue("VoteShop.Name", plugin.getGui().getData().getString("CHEST.VoteShopName"));
 		setValue("VoteShop.LimitReached", plugin.getGui().getData().getString("CHEST.VoteShopLimitReached"));
 		setValue("VoteShop.Disabled", plugin.getGui().getData().getString("CHEST.VoteShopDisabled"));
-
-		// sections
 		setValue("Shop", plugin.getGui().getData().getConfigurationSection("CHEST.Shop"));
 		setValue("ExtraItems", plugin.getGui().getData().getConfigurationSection("CHEST.VoteShopExtraItems"));
 		setValue("ShopConfirmPurchase", plugin.getGui().getData().getConfigurationSection("CHEST.ShopConfirmPurchase"));
 		saveData();
-
 	}
 
+	/**
+	 * Creates a new legacy shop item.
+	 *
+	 * @param value the identifier
+	 */
 	public void createShop(String value) {
 		ConfigurationSection shopData = getData().createSection("Shop." + value);
 		shopData.set("Identifier_Name", value);
@@ -106,77 +111,264 @@ public class ShopFile extends YMLFile {
 		shopData.set("Permission", "");
 		shopData.set("CloseGUI", true);
 		shopData.set("RequireConfirmation", false);
-
 		shopData.set("Rewards.Items.Item1.Material", "STONE");
 		shopData.set("Rewards.Items.Item1.Amount", 1);
 		saveData();
 	}
 
+	/**
+	 * Gets the categories section.
+	 *
+	 * @return the categories section
+	 */
+	public ConfigurationSection getCategoriesSection() {
+		return getData().getConfigurationSection("Categories");
+	}
+
+	/**
+	 * Gets a category section.
+	 *
+	 * @param categoryId the category id
+	 * @return the category section
+	 */
+	public ConfigurationSection getCategorySection(String categoryId) {
+		return getData().getConfigurationSection("Categories." + categoryId);
+	}
+
+	/**
+	 * Gets a category shop section.
+	 *
+	 * @param categoryId the category id
+	 * @return the category shop section
+	 */
+	public ConfigurationSection getCategoryShopSection(String categoryId) {
+		return getData().getConfigurationSection("Categories." + categoryId + ".Shop");
+	}
+
+	/**
+	 * Checks if a category back button is enabled.
+	 *
+	 * @param category the category id
+	 * @return true if enabled
+	 */
+	public boolean isCategoryBackButtonEnabled(String category) {
+		return getData().getBoolean("Categories." + category + ".BackButton", false);
+	}
+
+	/**
+	 * Gets the category back button item section.
+	 *
+	 * @param category the category id
+	 * @return configuration section or null
+	 */
+	public ConfigurationSection getCategoryBackButtonItem(String category) {
+		String path = "Categories." + category + ".BackButtonItem";
+
+		if (getData().isConfigurationSection(path)) {
+			return getData().getConfigurationSection(path);
+		}
+
+		return null;
+	}
+
+	/**
+	 * Gets the default VoteShop back button item.
+	 *
+	 * @return configuration section or null
+	 */
+	public ConfigurationSection getDefaultBackButtonItem() {
+		if (getData().isConfigurationSection("VoteShop.BackButtonItem")) {
+			return getData().getConfigurationSection("VoteShop.BackButtonItem");
+		}
+		return null;
+	}
+
+	/**
+	 * Gets the display section for an entry, preferring DisplayItem when present.
+	 *
+	 * @param section the entry section
+	 * @return the display section
+	 */
+	public ConfigurationSection getDisplaySection(ConfigurationSection section) {
+		if (section == null) {
+			return null;
+		}
+		ConfigurationSection displaySection = section.getConfigurationSection("DisplayItem");
+		if (displaySection != null) {
+			return displaySection;
+		}
+		return section;
+	}
+
+	/**
+	 * Gets the configuration for a vote shop extra item.
+	 *
+	 * @param item the item identifier
+	 * @return the configuration section
+	 */
 	public ConfigurationSection getGUIVoteShopExtraItems(String item) {
 		return getData().getConfigurationSection("ExtraItems." + item);
 	}
 
+	/**
+	 * Gets the cost of a shop item.
+	 *
+	 * @param identifier the shop identifier
+	 * @return the cost
+	 */
 	public int getShopIdentifierCost(String identifier) {
 		return getData().getInt("Shop." + identifier + ".Cost");
 	}
 
+	/**
+	 * Gets the identifier name for a shop item.
+	 *
+	 * @param identifier the shop identifier
+	 * @return the identifier name
+	 */
 	public String getShopIdentifierIdentifierName(String identifier) {
 		return getData().getString("Shop." + identifier + ".Identifier_Name", identifier);
 	}
 
+	/**
+	 * Gets the purchase limit for a shop item.
+	 *
+	 * @param identifier the shop identifier
+	 * @return the purchase limit
+	 */
 	public int getShopIdentifierLimit(String identifier) {
 		return getData().getInt("Shop." + identifier + ".Limit", -1);
 	}
 
+	/**
+	 * Gets the rewards path for a shop item.
+	 *
+	 * @param identifier the shop identifier
+	 * @return the rewards path
+	 */
 	public String getShopIdentifierRewardsPath(String identifier) {
 		return "Shop." + identifier + ".Rewards";
 	}
 
+	/**
+	 * Gets all shop identifiers.
+	 *
+	 * @return the set of shop identifiers
+	 */
 	public Set<String> getShopIdentifiers() {
 		ConfigurationSection shop = getData().getConfigurationSection("Shop");
 		if (shop != null) {
 			return shop.getKeys(false);
 		}
-		return new HashSet<>();
+		return new HashSet<String>();
 	}
 
+	/**
+	 * Gets the shop root section.
+	 *
+	 * @return the shop section
+	 */
+	public ConfigurationSection getShopSection() {
+		return getData().getConfigurationSection("Shop");
+	}
+
+	/**
+	 * Gets the configuration section for a shop item.
+	 *
+	 * @param identifier the shop identifier
+	 * @return the configuration section
+	 */
 	public ConfigurationSection getShopIdentifierSection(String identifier) {
 		return getData().getConfigurationSection("Shop." + identifier);
 	}
 
+	/**
+	 * Checks if the GUI should close on purchase.
+	 *
+	 * @param shop the shop identifier
+	 * @return true if GUI should close
+	 */
 	public boolean getVoteShopCloseGUI(String shop) {
 		return getData().getBoolean("Shop." + shop + ".CloseGUI", true);
 	}
 
+	/**
+	 * Checks if the shop item should be hidden when player has no permission.
+	 *
+	 * @param shop the shop identifier
+	 * @return true if should hide
+	 */
 	public boolean getVoteShopHideOnNoPermission(String shop) {
 		return getData().getBoolean("Shop." + shop + ".HideOnNoPermission", true);
 	}
 
+	/**
+	 * Checks if the shop item is not buyable.
+	 *
+	 * @param shop the shop identifier
+	 * @return true if not buyable
+	 */
 	public boolean getVoteShopNotBuyable(String shop) {
 		return getData().getBoolean("Shop." + shop + ".NotBuyable", false);
 	}
 
+	/**
+	 * Gets the permission required for a shop item.
+	 *
+	 * @param ident the shop identifier
+	 * @return the permission
+	 */
 	public String getVoteShopPermission(String ident) {
 		return getData().getString("Shop." + ident + ".Permission", "");
 	}
 
+	/**
+	 * Gets the purchase message for a shop item.
+	 *
+	 * @param identifier the shop identifier
+	 * @return the purchase message
+	 */
 	public String getVoteShopPurchase(String identifier) {
 		return getData().getString("Shop." + identifier + ".PurchaseMessage",
 				plugin.getConfigFile().getFormatShopPurchaseMsg());
 	}
 
+	/**
+	 * Checks if the shop item resets daily.
+	 *
+	 * @param shop the shop identifier
+	 * @return true if resets daily
+	 */
 	public boolean getVoteShopResetDaily(String shop) {
 		return getData().getBoolean("Shop." + shop + ".Reset.Daily", false);
 	}
 
+	/**
+	 * Checks if the shop item resets monthly.
+	 *
+	 * @param shop the shop identifier
+	 * @return true if resets monthly
+	 */
 	public boolean getVoteShopResetMonthly(String shop) {
 		return getData().getBoolean("Shop." + shop + ".Reset.Monthly", false);
 	}
 
+	/**
+	 * Checks if the shop item resets weekly.
+	 *
+	 * @param shop the shop identifier
+	 * @return true if resets weekly
+	 */
 	public boolean getVoteShopResetWeekly(String shop) {
 		return getData().getBoolean("Shop." + shop + ".Reset.Weekly", false);
 	}
 
+	/**
+	 * Checks if the shop item requires purchase confirmation.
+	 *
+	 * @param identifier the shop identifier
+	 * @return true if requires confirmation
+	 */
 	public boolean isVoteShopRequireConfirmation(String identifier) {
 		return getData().getBoolean("Shop." + identifier + ".RequireConfirmation", isVoteShopRequireConfirmation());
 	}
@@ -191,8 +383,13 @@ public class ShopFile extends YMLFile {
 		plugin.saveResource("Shop.yml", true);
 	}
 
+	/**
+	 * Removes a shop item.
+	 *
+	 * @param value the shop identifier
+	 */
 	public void removeShop(String value) {
 		getData().set("Shop." + value, null);
 		saveData();
 	}
-}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/config/SpecialRewardsConfig.java

@@ -3,7 +3,6 @@ package com.bencodez.votingplugin.config;
 import java.io.File;
 import java.util.ArrayList;
 import java.util.HashSet;
-import java.util.List;
 import java.util.Set;
 
 import com.bencodez.simpleapi.file.YMLFile;
@@ -16,18 +15,14 @@ import com.bencodez.simpleapi.file.annotation.ConfigDataListInt;
 import com.bencodez.simpleapi.file.annotation.ConfigDataListString;
 import com.bencodez.simpleapi.file.annotation.ConfigDataString;
 import com.bencodez.votingplugin.VotingPluginMain;
-import com.bencodez.votingplugin.topvoter.TopVoter;
 
 import lombok.Getter;
 
+/**
+ * The SpecialRewardsConfig class manages special rewards configuration.
+ */
 public class SpecialRewardsConfig extends YMLFile {
 
-	@Getter
-	private String allSitesRewardPath = "AllSites";
-
-	@Getter
-	private String almostAllSitesRewardPath = "AlmostAllSites";
-
 	@Getter
 	private String anySiteRewardsPath = "AnySiteRewards";
 
@@ -43,16 +38,6 @@ public class SpecialRewardsConfig extends YMLFile {
 	@Getter
 	private boolean enableWeeklyAwards = false;
 
-	@ConfigDataBoolean(path = "OnlyOneCumulative")
-	@Getter
-	private boolean onlyOneCumulative = false;
-
-	@Getter
-	private String firstVoteRewardsPath = "FirstVote";
-
-	@Getter
-	private String firstVoteTodayRewardsPath = "FirstVoteToday";
-
 	/** The plugin. */
 	private VotingPluginMain plugin;
 
@@ -72,14 +57,18 @@ public class SpecialRewardsConfig extends YMLFile {
 	@Getter
 	private boolean votePartyResetExtraVotesWeekly = false;
 
-	@ConfigDataString(path = "VoteParty.VoteReminderBroadcast")
+	@ConfigDataString(path = "VoteParty.VoteReminder.Broadcast", secondPath = "VoteParty.VoteReminderBroadcast")
 	@Getter
 	private String votePartyVoteReminderBroadcast = "%votesrequired% left to go, go vote!";
 
-	@ConfigDataListInt(path = "VoteParty.VoteReminderAtVotes")
+	@ConfigDataListInt(path = "VoteParty.VoteReminder.AtVotes", secondPath = "VoteParty.VoteReminderAtVotes")
 	@Getter
 	private ArrayList<Integer> votePartyVoteReminderAtVotes = new ArrayList<>();
 
+	@ConfigDataListString(path = "VoteParty.VoteReminder.Commands", secondPath = "VoteParty.VoteReminderCommands")
+	@Getter
+	private ArrayList<String> votePartyVoteReminderCommands = new ArrayList<>();
+
 	@ConfigDataListString(path = "VoteParty.GlobalRandomCommand")
 	@Getter
 	private ArrayList<String> votePartyGlobalRandomCommand = new ArrayList<>();
@@ -103,22 +92,10 @@ public class SpecialRewardsConfig extends YMLFile {
 	@Getter
 	private double voteStreakRequirementWeek = 50;
 
-	@ConfigDataKeys(path = "Cumulative")
-	@Getter
-	private Set<String> cumulativeVotes = new HashSet<>();
-
 	@ConfigDataKeys(path = "DailyAwards")
 	@Getter
 	private Set<String> dailyPossibleRewardPlaces = new HashSet<>();
 
-	@ConfigDataKeys(path = "MileStones")
-	@Getter
-	private Set<String> milestoneVotes = new HashSet<>();
-
-	@ConfigDataBoolean(path = "ResetMilestonesMonthly")
-	@Getter
-	private boolean resetMilestonesMonthly = false;
-
 	@ConfigDataString(path = "VoteParty.Broadcast")
 	@Getter
 	private String votePartyBroadcast = "";
@@ -183,82 +160,48 @@ public class SpecialRewardsConfig extends YMLFile {
 	@Getter
 	private Set<String> weeklyPossibleRewardPlaces = new HashSet<>();
 
+	@ConfigDataBoolean(path = "NameMCLikeReward.Enabled")
+	@Getter
+	private boolean nameMCLikeRewardEnabled = false;
+
+	@ConfigDataString(path = "NameMCLikeReward.Url")
+	@Getter
+	private String nameMCLikeRewardUrl = "";
+
+	@ConfigDataInt(path = "NameMCLikeReward.CheckIntervalMinutes")
+	@Getter
+	private int nameMCLikeRewardCheckIntervalMinutes = 10;
+
+	@Getter
+	private final String nameMCLikeRewardPath = "NameMCLikeReward.Rewards";
+
+	/**
+	 * Constructs a new SpecialRewardsConfig.
+	 *
+	 * @param plugin the main plugin instance
+	 */
 	public SpecialRewardsConfig(VotingPluginMain plugin) {
 		super(plugin, new File(plugin.getDataFolder(), "SpecialRewards.yml"));
+		setIgnoreCase(plugin.getConfigFile().isCaseInsensitiveYMLFiles());
 		this.plugin = plugin;
 	}
 
-	public List<Integer> getCumulativeBlackList(int cumulative) {
-		return getData().getIntegerList("Cumulative." + cumulative + ".BlackList");
-	}
-
-	public boolean getCumulativeRecurring(int cumulative) {
-		return getData().getBoolean("Cumulative." + cumulative + ".Recurring", true);
-	}
-
-	public boolean getCumulativeRewardEnabled(int cumulative) {
-		return getData().getBoolean("Cumulative." + cumulative + ".Enabled");
-	}
-
-	public String getCumulativeRewardsPath(int cumulative) {
-		return "Cumulative." + cumulative + ".Rewards";
-	}
-
-	@Deprecated
-	public boolean getCumulativeVotesInSameDay(int cumulative) {
-		return getData().getBoolean("Cumulative." + cumulative + ".VotesInSameDay");
-	}
-
-	@Deprecated
-	public boolean getCumulativeVotesInSameMonth(int cumulative) {
-		return getData().getBoolean("Cumulative." + cumulative + ".VotesInSameMonth");
-	}
-
-	@Deprecated
-	public boolean getCumulativeVotesInSameWeek(int cumulative) {
-		return getData().getBoolean("Cumulative." + cumulative + ".VotesInSameWeek");
-	}
-
-	public String getCumulativeVotesTotal(int cumulative) {
-		String str = getData().getString("Cumulative." + cumulative + ".TotalToUse", "");
-		if (str.isEmpty()) {
-			if (getCumulativeVotesInSameMonth(cumulative)) {
-				return TopVoter.Monthly.toString();
-			}
-			if (getCumulativeVotesInSameWeek(cumulative)) {
-				return TopVoter.Weekly.toString();
-			}
-			if (getCumulativeVotesInSameDay(cumulative)) {
-				return TopVoter.Daily.toString();
-			}
-		}
-		return str;
-	}
-
+	/**
+	 * Gets the rewards path for a daily award.
+	 *
+	 * @param path the award path
+	 * @return the daily award rewards path
+	 */
 	public String getDailyAwardRewardsPath(String path) {
 		return "DailyAwards." + path + ".Rewards";
 	}
 
 	/**
-	 * Gets the milestone reward enabled.
+	 * Gets the rewards path for a monthly award.
 	 *
-	 * @param milestones the milestones
-	 * @return the milestone reward enabled
+	 * @param path the award path
+	 * @return the monthly award rewards path
 	 */
-	public boolean getMilestoneRewardEnabled(int milestones) {
-		return getData().getBoolean("MileStones." + milestones + ".Enabled");
-	}
-
-	/**
-	 * Gets the milestone rewards.
-	 *
-	 * @param milestones the milestones
-	 * @return the milestone rewards
-	 */
-	public String getMilestoneRewardsPath(int milestones) {
-		return "MileStones." + milestones + ".Rewards";
-	}
-
 	public String getMonthlyAwardRewardsPath(String path) {
 		return "MonthlyAwards." + path + ".Rewards";
 	}
@@ -276,6 +219,12 @@ public class SpecialRewardsConfig extends YMLFile {
 		}
 	}
 
+	/**
+	 * Gets the increase votes required with the old typo field.
+	 *
+	 * @return the increase votes required
+	 * @deprecated Use getVotePartyIncreaseVotesRequired instead
+	 */
 	public int getVotePartyIncreaseVotesRequiredWithTypo() {
 		int increase = getVotePartyIncreaseVotesRequired();
 		if (increase > 0) {
@@ -284,14 +233,34 @@ public class SpecialRewardsConfig extends YMLFile {
 		return getVotePartyIncreaseVotesRquired();
 	}
 
+	/**
+	 * Checks if a vote streak reward is enabled.
+	 *
+	 * @param type the streak type
+	 * @param s    the streak value
+	 * @return true if enabled
+	 */
 	public boolean getVoteStreakRewardEnabled(String type, String s) {
 		return getData().getBoolean("VoteStreak." + type + "." + s + ".Enabled");
 	}
 
+	/**
+	 * Gets the rewards path for a vote streak.
+	 *
+	 * @param type   the streak type
+	 * @param string the streak value
+	 * @return the vote streak rewards path
+	 */
 	public String getVoteStreakRewardsPath(String type, String string) {
 		return "VoteStreak." + type + "." + string + ".Rewards";
 	}
 
+	/**
+	 * Gets all vote streak values for a type.
+	 *
+	 * @param type the streak type
+	 * @return the set of vote streak values
+	 */
 	public Set<String> getVoteStreakVotes(String type) {
 		try {
 			Set<String> set = getData().getConfigurationSection("VoteStreak." + type).getKeys(false);
@@ -304,6 +273,12 @@ public class SpecialRewardsConfig extends YMLFile {
 		}
 	}
 
+	/**
+	 * Gets the rewards path for a weekly award.
+	 *
+	 * @param path the award path
+	 * @return the weekly award rewards path
+	 */
 	public String getWeeklyAwardRewardsPath(String path) {
 		return "WeeklyAwards." + path + ".Rewards";
 	}
@@ -318,27 +293,25 @@ public class SpecialRewardsConfig extends YMLFile {
 		plugin.saveResource("SpecialRewards.yml", true);
 	}
 
-	public void removeCumulative(String votes) {
-		getData().set("Cumulative." + votes, null);
+	/**
+	 * Removes a vote milestone.
+	 *
+	 * @param votes the milestone votes value
+	 */
+	public void removeVoteMilestone(String votes) {
+		getData().set("VoteMilestones." + votes, null);
 		saveData();
 	}
 
-	public void removeMilestone(String votes) {
-		getData().set("MileStones." + votes, null);
-		saveData();
-	}
-
-	public void setCumulative(int intValue) {
-		getData().set("Cumulative." + intValue + ".Enabled", true);
-		getData().set("Cumulative." + intValue + ".TotalToUse", "AllTime");
-		getData().set("Cumulative." + intValue + ".Rewards.Messages.Player",
-				"&aYou got %cumulative% cumulative votes!");
-		saveData();
-	}
-
-	public void setMilestone(int intValue) {
-		getData().set("MileStones." + intValue + ".Enabled", true);
-		getData().set("MileStones." + intValue + ".Rewards.Messages.Player", "&aYou got %milestone% milestone votes!");
+	/**
+	 * Sets a vote milestone with default values.
+	 *
+	 * @param intValue the milestone votes value
+	 */
+	public void setVoteMilestone(int intValue) {
+		getData().set("VoteMilestones." + intValue + ".Enabled", true);
+		getData().set("VoteMilestones." + intValue + ".Rewards.Messages.Player",
+				"&aYou got %milestone% milestone votes!");
 		saveData();
 	}
 }

VotingPlugin/src/main/java/com/bencodez/votingplugin/cooldown/CoolDownCheck.java

@@ -0,0 +1,435 @@
+package com.bencodez.votingplugin.cooldown;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.ScheduledFuture;
+import java.util.concurrent.ScheduledThreadPoolExecutor;
+import java.util.concurrent.TimeUnit;
+
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.EventPriority;
+import org.bukkit.event.Listener;
+
+import com.bencodez.advancedcore.api.rewards.RewardOptions;
+import com.bencodez.advancedcore.api.user.AdvancedCoreUser;
+import com.bencodez.advancedcore.api.user.UserDataFetchMode;
+import com.bencodez.advancedcore.api.user.UserStartup;
+import com.bencodez.votingplugin.VotingPluginMain;
+import com.bencodez.votingplugin.events.PlayerVoteCoolDownEndEvent;
+import com.bencodez.votingplugin.events.PlayerVoteSiteCoolDownEndEvent;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.NextSite;
+import com.bencodez.votingplugin.votesites.VoteSite;
+
+import lombok.Getter;
+
+/**
+ * Manages cooldown checks for vote rewards.
+ */
+public class CoolDownCheck implements Listener {
+
+	private final VotingPluginMain plugin;
+
+	private final Map<UUID, ScheduledFuture<?>> perSiteTasks = new ConcurrentHashMap<>();
+	private final Map<UUID, ScheduledFuture<?>> allSiteTasks = new ConcurrentHashMap<>();
+
+	@Getter
+	private final ScheduledExecutorService timer;
+
+	private volatile boolean cooldownCheckEnabled = false;
+
+	/**
+	 * Constructs a new cooldown check manager.
+	 *
+	 * @param plugin the plugin instance
+	 */
+	public CoolDownCheck(VotingPluginMain plugin) {
+		this.plugin = plugin;
+
+		// Better behavior when you cancel+reschedule a lot (removes cancelled tasks from queue)
+		ScheduledThreadPoolExecutor exec = new ScheduledThreadPoolExecutor(1);
+		exec.setRemoveOnCancelPolicy(true);
+		this.timer = exec;
+	}
+
+	/**
+	 * Checks the cooldown for a player by UUID.
+	 *
+	 * @param uuid the player UUID
+	 */
+	public void check(UUID uuid) {
+		VotingPluginUser user = plugin.getVotingPluginUserManager().getVotingPluginUser(uuid);
+		if (!user.isOnline()) {
+			user.userDataFetechMode(UserDataFetchMode.NO_CACHE);
+		}
+		check(user);
+	}
+
+	/**
+	 * Shuts down the cooldown check timer.
+	 */
+	public void shutdown() {
+		timer.shutdownNow();
+
+		for (ScheduledFuture<?> f : perSiteTasks.values()) {
+			if (f != null) {
+				f.cancel(false);
+			}
+		}
+		for (ScheduledFuture<?> f : allSiteTasks.values()) {
+			if (f != null) {
+				f.cancel(false);
+			}
+		}
+
+		perSiteTasks.clear();
+		allSiteTasks.clear();
+	}
+
+	/**
+	 * Checks the cooldown for a user.
+	 *
+	 * @param user the voting plugin user
+	 */
+	public synchronized void check(VotingPluginUser user) {
+		if (!user.getCoolDownCheck()) {
+			return;
+		}
+
+		if (user.canVoteAll()) {
+			user.setCoolDownCheck(false);
+
+			PlayerVoteCoolDownEndEvent event = new PlayerVoteCoolDownEndEvent(user);
+			plugin.getServer().getPluginManager().callEvent(event);
+
+			ScheduledFuture<?> f = allSiteTasks.remove(user.getJavaUUID());
+			if (f != null) {
+				f.cancel(false);
+			}
+			return;
+		}
+
+		// Keep per-site scheduling going while waiting for "all sites available"
+		schedulePerSite(user, false);
+	}
+
+	/**
+	 * Check ONLY a specific votesite for all users (uses streaming keys/cols).
+	 *
+	 * @param site the vote site to check
+	 */
+	public void checkAllVoteSite(VoteSite site) {
+		if (site == null) {
+			return;
+		}
+
+		plugin.getLogger().info("Checking vote cooldown rewards for all players: " + site.getKey());
+
+		plugin.getUserManager().forEachUserKeys((uuid, cols) -> {
+			if (!plugin.isEnabled() || uuid == null) {
+				return;
+			}
+
+			VotingPluginUser user = plugin.getVotingPluginUserManager().getVotingPluginUser(uuid, false);
+			if (user == null) {
+				return;
+			}
+
+			user.userDataFetechMode(UserDataFetchMode.TEMP_ONLY);
+
+			try {
+				if (cols != null) {
+					user.updateTempCacheWithColumns(cols);
+					cols.clear(); // help GC (only useful if reused)
+				}
+
+				checkPerSite(site, user);
+			} finally {
+				user.clearTempCache();
+			}
+		}, (count) -> plugin.getLogger().info("Finished checking vote cooldown rewards for all players: " + site.getKey()
+				+ " (processed: " + count + ")"));
+	}
+
+	/**
+	 * Checks if cooldown check is enabled.
+	 */
+	public void checkEnabled() {
+		cooldownCheckEnabled = !plugin.getConfigFile().isDisableCoolDownCheck()
+				&& plugin.getRewardHandler().hasRewards(plugin.getSpecialRewardsConfig().getData(),
+						"VoteCoolDownEndedReward");
+	}
+
+	/**
+	 * Checks per-site cooldown for a player by UUID.
+	 *
+	 * @param uuid the player UUID
+	 */
+	public void checkPerSite(UUID uuid) {
+		VotingPluginUser user = plugin.getVotingPluginUserManager().getVotingPluginUser(uuid);
+		if (!user.isOnline()) {
+			user.userDataFetechMode(UserDataFetchMode.NO_CACHE);
+		}
+		checkPerSite(user);
+	}
+
+	/**
+	 * Checks per-site cooldown for a user.
+	 *
+	 * @param user the voting plugin user
+	 */
+	public synchronized void checkPerSite(VotingPluginUser user) {
+		if (!plugin.getConfigFile().isPerSiteCoolDownEvents()) {
+			return;
+		}
+
+		HashMap<String, Boolean> coolDownChecks = user.getCoolDownCheckSiteList();
+		boolean changed = false;
+
+		for (VoteSite site : plugin.getVoteSiteManager().getVoteSitesEnabled()) {
+			if (site == null) {
+				continue;
+			}
+
+			if (!Boolean.TRUE.equals(coolDownChecks.get(site.getKey()))) {
+				if (user.canVoteSite(site)) {
+					coolDownChecks.put(site.getKey(), Boolean.TRUE);
+					changed = true;
+
+					plugin.extraDebug("Triggering votesitecooldownend event for " + user.getUUID());
+					PlayerVoteSiteCoolDownEndEvent event = new PlayerVoteSiteCoolDownEndEvent(user, site);
+					plugin.getServer().getPluginManager().callEvent(event);
+				}
+			}
+		}
+
+		if (changed) {
+			user.setCoolDownCheckSite(coolDownChecks);
+		}
+
+		schedulePerSite(user, false);
+	}
+
+	/**
+	 * Site-specific version used by batch checks / checkAllVoteSite.
+	 */
+	private void checkPerSite(VoteSite site, VotingPluginUser user) {
+		if (!plugin.getConfigFile().isPerSiteCoolDownEvents() || site == null) {
+			return;
+		}
+
+		HashMap<String, Boolean> coolDownChecks = user.getCoolDownCheckSiteList();
+		if (Boolean.TRUE.equals(coolDownChecks.get(site.getKey()))) {
+			return;
+		}
+
+		if (user.canVoteSite(site)) {
+			coolDownChecks.put(site.getKey(), Boolean.TRUE);
+			user.setCoolDownCheckSite(coolDownChecks);
+
+			plugin.extraDebug(
+					"Triggering votesitecooldownend event on site " + site.getKey() + " for " + user.getUUID());
+			PlayerVoteSiteCoolDownEndEvent event = new PlayerVoteSiteCoolDownEndEvent(user, site);
+			plugin.getServer().getPluginManager().callEvent(event);
+		}
+	}
+
+	/**
+	 * Loads the cooldown check system.
+	 */
+	public void load() {
+		plugin.addUserStartup(new UserStartup() {
+
+			@Override
+			public void onFinish() {
+				checkAllVoteSites();
+			}
+
+			@Override
+			public void onStart() {
+			}
+
+			@Override
+			public void onStartUp(AdvancedCoreUser advancedcoreUser) {
+			}
+		});
+	}
+
+	/**
+	 * Handles the cooldown end event.
+	 *
+	 * @param event the cooldown end event
+	 */
+	@EventHandler(priority = EventPriority.MONITOR, ignoreCancelled = true)
+	public void onCoolDownEnd(PlayerVoteCoolDownEndEvent event) {
+		plugin.getRewardHandler().giveReward(event.getPlayer(), plugin.getSpecialRewardsConfig().getData(),
+				"VoteCoolDownEndedReward", new RewardOptions());
+	}
+
+	/**
+	 * Handles the per-site cooldown end event.
+	 *
+	 * @param event the per-site cooldown end event
+	 */
+	@EventHandler(priority = EventPriority.MONITOR, ignoreCancelled = true)
+	public void onCoolDownEnd(PlayerVoteSiteCoolDownEndEvent event) {
+		plugin.getRewardHandler().giveReward(event.getPlayer(), event.getSite().getSiteData(), "CoolDownEndRewards",
+				new RewardOptions().addPlaceholder("sitename", event.getSite().getDisplayName())
+						.addPlaceholder("url", event.getSite().getVoteURL(false)));
+	}
+
+	/**
+	 * Schedules a cooldown check for a user.
+	 *
+	 * @param user the voting plugin user
+	 * @param force whether to force the schedule
+	 */
+	public void schedule(VotingPluginUser user, boolean force) {
+		if (user.getSitesVotedOn() <= 0 && !force) {
+			return;
+		}
+
+		final UUID uuid = user.getJavaUUID();
+		final long time = user.getNextTimeAllSitesAvailable();
+
+		allSiteTasks.compute(uuid, (k, existing) -> {
+			if (existing != null) {
+				existing.cancel(false);
+			}
+
+			if (time <= 0) {
+				plugin.extraDebug(user.getUUID() + "/" + user.getPlayerName() + " not scheduling cooldown check");
+				return null; // remove entry
+			}
+
+			user.setCoolDownCheck(true);
+
+			return timer.schedule(() -> {
+				if (plugin.isEnabled()) {
+					check(uuid);
+				}
+			}, time + 2, TimeUnit.SECONDS);
+		});
+	}
+
+	/**
+	 * Schedules per-site cooldown checks for a user.
+	 *
+	 * @param user the voting plugin user
+	 * @param force whether to force the schedule
+	 */
+	public void schedulePerSite(VotingPluginUser user, boolean force) {
+		if (!plugin.getConfigFile().isPerSiteCoolDownEvents()) {
+			return;
+		}
+
+		if (user.getSitesVotedOn() <= 0 && !force) {
+			return;
+		}
+
+		final UUID uuid = user.getJavaUUID();
+
+		final NextSite next = user.getNextSiteAvailable();
+
+		perSiteTasks.compute(uuid, (k, existing) -> {
+			if (existing != null) {
+				existing.cancel(false);
+			}
+
+			if (next == null || next.getSite() == null || next.getSecondsUntilAvailable() <= 0) {
+				plugin.extraDebug(user.getUUID() + "/" + user.getPlayerName() + " not scheduling per-site cooldown check");
+				return null; // remove entry
+			}
+
+			plugin.devDebug("PerSiteCoolDownEvent schedule: site=" + next.getSite().getKey() + " time="
+					+ next.getSecondsUntilAvailable() + " seconds");
+
+			return timer.schedule(() -> {
+				if (!plugin.isEnabled()) {
+					return;
+				}
+
+				// Only check the next site; this will set the cooldown-end flag + fire event if ready
+				checkPerSite(next.getSite(), user);
+
+				// Schedule the following site (if any)
+				schedulePerSite(user, false);
+
+			}, next.getSecondsUntilAvailable() + 2, TimeUnit.SECONDS);
+		});
+	}
+
+	/**
+	 * Handles a vote event for cooldown scheduling.
+	 *
+	 * @param user the voting plugin user
+	 * @param site the vote site
+	 */
+	public void vote(VotingPluginUser user, VoteSite site) {
+		if (cooldownCheckEnabled) {
+			schedule(user, true);
+		}
+
+		if (plugin.getConfigFile().isPerSiteCoolDownEvents()) {
+			user.setCoolDownCheckSite(site, Boolean.FALSE);
+			schedulePerSite(user, true);
+		}
+	}
+
+	/**
+	 * Performance-optimized: scan users ONCE, process all daily-delay sites.
+	 */
+	public void checkAllVoteSites() {
+		final List<VoteSite> sites = plugin.getVoteSiteManager().getVoteSites();
+		if (sites == null || sites.isEmpty()) {
+			return;
+		}
+
+		final ArrayList<VoteSite> dailySites = new ArrayList<>();
+		for (int i = 0; i < sites.size(); i++) {
+			VoteSite site = sites.get(i);
+			if (site != null && site.isVoteDelayDaily()) {
+				dailySites.add(site);
+			}
+		}
+
+		if (dailySites.isEmpty()) {
+			return;
+		}
+
+		plugin.debug("Checking vote cooldown rewards for all players across " + dailySites.size() + " sites...");
+
+		plugin.getUserManager().forEachUserKeys((uuid, cols) -> {
+			if (!plugin.isEnabled() || uuid == null) {
+				return;
+			}
+
+			VotingPluginUser user = plugin.getVotingPluginUserManager().getVotingPluginUser(uuid, false);
+			if (user == null) {
+				return;
+			}
+
+			user.userDataFetechMode(UserDataFetchMode.TEMP_ONLY);
+
+			try {
+				if (cols != null) {
+					user.updateTempCacheWithColumns(cols);
+					cols.clear();
+				}
+
+				for (int i = 0; i < dailySites.size(); i++) {
+					checkPerSite(dailySites.get(i), user);
+				}
+
+				check(user);
+			} finally {
+				user.clearTempCache();
+			}
+		}, (count) -> plugin.debug("Finished checking vote cooldown rewards (processed: " + count + " users)"));
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/data/ServerData.java

@@ -26,10 +26,20 @@ public class ServerData {
 
 	private VotingPluginMain plugin = VotingPluginMain.plugin;
 
+	/**
+	 * Constructs a new ServerData.
+	 *
+	 * @param plugin the main plugin instance
+	 */
 	public ServerData(VotingPluginMain plugin) {
 		this.plugin = plugin;
 	}
 
+	/**
+	 * Adds an auto-cached placeholder.
+	 *
+	 * @param placeholder the placeholder to add
+	 */
 	public void addAutoCachedPlaceholder(String placeholder) {
 		List<String> p = getAutoCachedPlaceholder();
 
@@ -39,6 +49,11 @@ public class ServerData {
 		}
 	}
 
+	/**
+	 * Adds a service site to the list.
+	 *
+	 * @param site the service site to add
+	 */
 	public synchronized void addServiceSite(String site) {
 		ArrayList<String> l = getServiceSites();
 		if (!getServiceSites().contains(site)) {
@@ -69,6 +84,12 @@ public class ServerData {
 				getSignSkullLocation("" + count), getSignData("" + count), getSignPosition("" + count)));
 	}
 
+	/**
+	 * Adds a timed vote to the cache.
+	 *
+	 * @param num the vote number
+	 * @param vote the vote time queue entry
+	 */
 	public void addTimeVoted(int num, VoteTimeQueue vote) {
 		getData().set("TimedVoteCache." + num + ".Name", vote.getName());
 		getData().set("TimedVoteCache." + num + ".Service", vote.getService());
@@ -76,23 +97,46 @@ public class ServerData {
 		saveData();
 	}
 
+	/**
+	 * Adds a vote shop purchase for the specified identifier.
+	 *
+	 * @param ident the vote shop identifier
+	 */
 	public void addVoteShopPurchase(String ident) {
 		setVoteShopPurchases(ident, (getVoteShopPurchases(ident) + 1));
 	}
 
+	/**
+	 * Clears the timed vote cache.
+	 */
 	public void clearTimedVoteCache() {
 		getData().set("TimedVoteCache", null);
 		saveData();
 	}
 
+	/**
+	 * Gets the auto cached placeholders.
+	 *
+	 * @return the auto cached placeholder list
+	 */
 	public List<String> getAutoCachedPlaceholder() {
 		return getData().getStringList("AutoCachePlaceholders");
 	}
 
+	/**
+	 * Gets the current bungee vote party count.
+	 *
+	 * @return the bungee vote party current count
+	 */
 	public int getBungeeVotePartyCurrent() {
 		return getData().getInt("BungeeVotePartyCurrent");
 	}
 
+	/**
+	 * Gets the required votes for bungee vote party.
+	 *
+	 * @return the bungee vote party required votes
+	 */
 	public int getBungeeVotePartyRequired() {
 		return getData().getInt("BungeeVotePartyRequired");
 	}
@@ -111,13 +155,23 @@ public class ServerData {
 		return data;
 	}
 
+	/**
+	 * Gets the list of disabled reminders.
+	 *
+	 * @return the disabled reminders
+	 */
 	public List<String> getDisabledReminders() {
 		return getData().getStringList("DisabledReminders");
 	}
 
+	/**
+	 * Gets the service sites list.
+	 *
+	 * @return the service sites
+	 */
 	@SuppressWarnings("unchecked")
 	public ArrayList<String> getServiceSites() {
-		return (ArrayList<String>) getData().getList("ServiceSites", new ArrayList<>());
+		return (ArrayList<String>) getData().getList("GottenServiceSites", new ArrayList<>());
 	}
 
 	/**
@@ -180,6 +234,11 @@ public class ServerData {
 				getData().getDouble("Signs." + sign + ".Skull.Z"));
 	}
 
+	/**
+	 * Gets the timed vote cache keys.
+	 *
+	 * @return the timed vote cache keys
+	 */
 	public Set<String> getTimedVoteCacheKeys() {
 		if (getData().isConfigurationSection("TimedVoteCache")) {
 			return getData().getConfigurationSection("TimedVoteCache").getKeys(false);
@@ -187,18 +246,40 @@ public class ServerData {
 		return new HashSet<>();
 	}
 
+	/**
+	 * Gets the timed vote cache section for the given number.
+	 *
+	 * @param num the cache entry number
+	 * @return the timed vote cache section
+	 */
 	public ConfigurationSection getTimedVoteCacheSection(String num) {
 		return getData().getConfigurationSection("TimedVoteCache." + num);
 	}
 
+	/**
+	 * Gets the extra required votes for vote party.
+	 *
+	 * @return the vote party extra required votes
+	 */
 	public int getVotePartyExtraRequired() {
 		return getData().getInt("VotePartyExtraRequired", 0);
 	}
 
+	/**
+	 * Gets the number of purchases for a vote shop item.
+	 *
+	 * @param ident the vote shop identifier
+	 * @return the vote shop purchases
+	 */
 	public int getVoteShopPurchases(String ident) {
 		return getData().getInt("VoteShopPurchases." + ident);
 	}
 
+	/**
+	 * Checks if the last vote party was on the same day.
+	 *
+	 * @return true if same day
+	 */
 	public boolean isLastVotePartySameDay() {
 		int num = getData().getInt("LastVoteParty", 0);
 		if (num == plugin.getTimeChecker().getTime().getDayOfYear()) {
@@ -207,6 +288,11 @@ public class ServerData {
 		return false;
 	}
 
+	/**
+	 * Checks if the last vote party was in the same week.
+	 *
+	 * @return true if same week
+	 */
 	public boolean isLastVotePartySameWeek() {
 		int num = getData().getInt("LastVotePartyWeek", -1);
 		if (num == plugin.getTimeChecker().getTime().get(WeekFields.of(Locale.getDefault()).weekOfYear())
@@ -216,6 +302,11 @@ public class ServerData {
 		return false;
 	}
 
+	/**
+	 * Checks if the vote shop has been converted.
+	 *
+	 * @return true if converted
+	 */
 	public boolean isVoteShopConverted() {
 		return getData().getBoolean("VoteShopConverted");
 	}
@@ -245,10 +336,22 @@ public class ServerData {
 		plugin.getServerDataFile().reloadData();
 	}
 
+	/**
+	 * Gets the Discord message ID for the top voter.
+	 *
+	 * @param top the top voter type
+	 * @return the top voter message ID
+	 */
 	public long getTopVoterMessageId(TopVoter top) {
 		return getData().getLong("DiscordSRV.TopVoterMessageId." + top.toString(), 0);
 	}
 
+	/**
+	 * Sets the Discord message ID for the top voter.
+	 *
+	 * @param top the top voter type
+	 * @param messageId the message ID
+	 */
 	public void setTopVoterMessageId(TopVoter top, long messageId) {
 		getData().set("DiscordSRV.TopVoterMessageId." + top.toString(), messageId);
 		saveData();
@@ -281,6 +384,11 @@ public class ServerData {
 		plugin.getServerDataFile().saveData();
 	}
 
+	/**
+	 * Saves the disabled reminders list.
+	 *
+	 * @param disabledReminders the list of UUIDs with disabled reminders
+	 */
 	public void saveDisabledReminders(ArrayList<UUID> disabledReminders) {
 		ArrayList<String> uuids = new ArrayList<>();
 		for (UUID uuid : disabledReminders) {
@@ -290,31 +398,65 @@ public class ServerData {
 		saveData();
 	}
 
+	/**
+	 * Sets the auto cached placeholders.
+	 *
+	 * @param placeholders the list of placeholders
+	 */
 	public void setAutoCachedPlaceholder(List<String> placeholders) {
 		getData().set("AutoCachePlaceholders", placeholders);
 		saveData();
 	}
 
+	/**
+	 * Sets the current bungee vote party count.
+	 *
+	 * @param current the current vote count
+	 */
 	public void setBungeeVotePartyCurrent(int current) {
 		getData().set("BungeeVotePartyCurrent", current);
 		saveData();
 	}
 
+	/**
+	 * Sets the required votes for bungee vote party.
+	 *
+	 * @param required the required vote count
+	 */
 	public void setBungeeVotePartyRequired(int required) {
 		getData().set("BungeeVotePartyRequired", required);
 		saveData();
 	}
 
+	/**
+	 * Sets the service sites list.
+	 *
+	 * @param list the service sites list
+	 */
 	public void setServiceSites(ArrayList<String> list) {
-		getData().set("ServiceSites", list);
+		getData().set("GottenServiceSites", list);
 		saveData();
 	}
 
+	/**
+	 * Sets the vote shop converted status.
+	 *
+	 * @param value the converted status
+	 */
 	public void setShopConverted(boolean value) {
 		getData().set("VoteShopConverted", value);
 		saveData();
 	}
 
+	/**
+	 * Sets sign data.
+	 *
+	 * @param count the sign count
+	 * @param location the sign location
+	 * @param skullLocation the skull location
+	 * @param data the sign data
+	 * @param position the sign position
+	 */
 	public void setSign(String count, Location location, Location skullLocation, String data, int position) {
 
 		getData().set("Signs." + count + ".World", location.getWorld().getName());
@@ -332,6 +474,12 @@ public class ServerData {
 		saveData();
 	}
 
+	/**
+	 * Sets the skull location for a sign.
+	 *
+	 * @param count the sign count
+	 * @param skullLocation the skull location
+	 */
 	public void setSkullLocation(String count, Location skullLocation) {
 		if (skullLocation != null) {
 			getData().set("Signs." + count + ".Skull.World", skullLocation.getWorld().getName());
@@ -349,27 +497,47 @@ public class ServerData {
 		saveData();
 	}
 
+	/**
+	 * Sets the extra required votes for vote party.
+	 *
+	 * @param value the extra required votes
+	 */
 	public void setVotePartyExtraRequired(int value) {
 		getData().set("VotePartyExtraRequired", value);
 		saveData();
 	}
 
+	/**
+	 * Sets the number of purchases for a vote shop item.
+	 *
+	 * @param ident the vote shop identifier
+	 * @param amount the purchase amount
+	 */
 	public void setVoteShopPurchases(String ident, int amount) {
 		getData().set("VoteShopPurchases." + ident, amount);
 		saveData();
 	}
 
+	/**
+	 * Updates the last vote party timestamp to today.
+	 */
 	public void updateLastVoteParty() {
 		getData().set("LastVoteParty", plugin.getTimeChecker().getTime().getDayOfYear());
 		saveData();
 	}
 
+	/**
+	 * Updates the last vote party week timestamp to this week.
+	 */
 	public void updateLastVotePartyWeek() {
 		getData().set("LastVotePartyWeek",
 				plugin.getTimeChecker().getTime().get(WeekFields.of(Locale.getDefault()).weekOfYear()));
 		saveData();
 	}
 
+	/**
+	 * Updates placeholders to lowercase format.
+	 */
 	public void updatePlaceholders() {
 		boolean data = getData().getBoolean("AutoCacheUpdated", false);
 		if (!data) {

VotingPlugin/src/main/java/com/bencodez/votingplugin/discord/DiscordHandler.java

@@ -5,6 +5,7 @@ import java.time.Instant;
 import java.util.HashMap;
 import java.util.LinkedHashMap;
 import java.util.Map.Entry;
+import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
 
 import org.bukkit.configuration.ConfigurationSection;
@@ -12,6 +13,8 @@ import org.bukkit.configuration.ConfigurationSection;
 import com.bencodez.advancedcore.api.messages.PlaceholderUtils;
 import com.bencodez.advancedcore.api.rewards.Reward;
 import com.bencodez.advancedcore.api.rewards.injected.RewardInjectConfigurationSection;
+import com.bencodez.advancedcore.api.user.AdvancedCoreUser;
+import com.bencodez.advancedcore.api.user.UserStartup;
 import com.bencodez.votingplugin.VotingPluginMain;
 import com.bencodez.votingplugin.topvoter.TopVoter;
 import com.bencodez.votingplugin.topvoter.TopVoterPlayer;
@@ -25,6 +28,9 @@ import github.scarsz.discordsrv.dependencies.jda.api.entities.TextChannel;
 import github.scarsz.discordsrv.util.DiscordUtil;
 import lombok.Getter;
 
+/**
+ * Handler for Discord integration.
+ */
 public class DiscordHandler {
 
 	private final VotingPluginMain plugin;
@@ -32,6 +38,11 @@ public class DiscordHandler {
 	private final HashMap<TopVoter, Long> topVoterMessageIds = new HashMap<TopVoter, Long>();
 	private final AtomicBoolean discordReady = new AtomicBoolean(false);
 
+	/**
+	 * Constructs a new Discord handler.
+	 *
+	 * @param plugin the plugin instance
+	 */
 	public DiscordHandler(VotingPluginMain plugin) {
 		this.plugin = plugin;
 		for (TopVoter top : TopVoter.values()) {
@@ -65,9 +76,44 @@ public class DiscordHandler {
 				return null;
 			}
 		});
+
+		plugin.addUserStartup(new UserStartup() {
+
+			@Override
+			public void onStartUp(AdvancedCoreUser user) {
+
+			}
+
+			@Override
+			public void onStart() {
+
+			}
+
+			@Override
+			public void onPostFinish() {
+
+				plugin.getTimer().scheduleAtFixedRate(new Runnable() {
+
+					@Override
+					public void run() {
+						updateDiscordLeaderboard();
+					}
+				}, 130, 60 * 60, TimeUnit.SECONDS); // 10-minute interval
+			}
+
+			@Override
+			public void onFinish() {
+
+			}
+		});
+
 	}
 
-	/** Fired once JDA is fully initialized */
+	/**
+	 * Fired once JDA is fully initialized.
+	 *
+	 * @param event the Discord ready event
+	 */
 	@Subscribe
 	public void onDiscordReady(DiscordReadyEvent event) {
 		discordReady.set(true);
@@ -92,49 +138,79 @@ public class DiscordHandler {
 		}
 	}
 
+	/**
+	 * Updates the top voter message ID for the specified top voter.
+	 *
+	 * @param top the top voter
+	 */
 	public void updateTopVoterMessageId(TopVoter top) {
+		plugin.extraDebug("Updating Discord Top Voter message for: " + top);
+
 		long channelId = plugin.getConfigFile().getDiscordSRVTopVoterChannel(top);
 		LinkedHashMap<TopVoterPlayer, Integer> topVoters = plugin.getTopVoter(top);
 
 		String title = plugin.getConfigFile().getDiscordSRVTopVoterTitle(top);
-		String rankDisplay = plugin.getConfigFile().getDiscordSRVTopVoterRankDisplay(top);
+		boolean newMessage = plugin.getConfigFile().isDiscordSRVTopVoterNewMessageOnUpdate(top);
 
 		EmbedBuilder eb = new EmbedBuilder().setTitle(title).setColor(Color.CYAN).setTimestamp(Instant.now());
 
-		int rank = 1;
-		for (Entry<TopVoterPlayer, Integer> entry : topVoters.entrySet()) {
-			if (rank > 10)
-				break;
-			String line = rankDisplay.replace("%rank%", String.valueOf(rank))
-					.replace("%player%", entry.getKey().getPlayerName())
-					.replace("%votes%", String.valueOf(entry.getValue()));
-			eb.addField("", line, false);
-			rank++;
+		if (topVoters == null || topVoters.isEmpty()) {
+			eb.setDescription("No votes recorded yet.");
+		} else {
+			StringBuilder sb = new StringBuilder();
+			sb.append("```");
+			int rank = 1;
+
+			for (Entry<TopVoterPlayer, Integer> entry : topVoters.entrySet()) {
+				if (rank > 10)
+					break;
+
+				String prefix = rank <= 3 ? new String[] { "🥇", "🥈", "🥉" }[rank - 1] : rank + ".";
+
+				String player = entry.getKey().getPlayerName();
+				int votes = entry.getValue();
+
+				// simple alignment: trim long names, pad to 16 chars
+				if (player.length() > 16)
+					player = player.substring(0, 16);
+
+				sb.append(String.format("%-3s %-16s %4d votes%n", prefix, player, votes));
+				rank++;
+			}
+			sb.append("```");
+
+			eb.setDescription(sb.toString()).setFooter("Top 10 • Updated");
 		}
 
 		TextChannel channel = DiscordUtil.getJda().getTextChannelById(channelId);
 		if (channel == null) {
-			plugin.getLogger().warning("Discord channel ID " + channelId + " not found: " + top.toString());
+			plugin.getLogger().warning("Discord channel ID " + channelId + " not found: " + top);
 			return;
 		}
 
-		if (topVoterMessageIds.get(top) <= 0) {
+		long existingId = topVoterMessageIds.getOrDefault(top, 0L);
+
+		if (existingId <= 0 || newMessage) {
 			channel.sendMessageEmbeds(eb.build()).queue(msg -> {
 				long newId = msg.getIdLong();
 				topVoterMessageIds.put(top, newId);
-				plugin.getServerData().setTopVoterMessageId(top, newId);
-				plugin.getLogger().info("Posted new Top Voters  " + top.toString() + " (ID: " + newId + ")");
-			}, err -> plugin.getLogger()
-					.warning("Error sending Top Voters " + top.toString() + ": " + err.getMessage()));
+				if (!newMessage)
+					plugin.getServerData().setTopVoterMessageId(top, newId);
+				plugin.debug("Posted new Top Voters " + top + " (ID: " + newId + ")");
+			}, err -> plugin.getLogger().warning("Error sending Top Voters " + top + ": " + err.getMessage()));
 		} else {
-			channel.editMessageEmbedsById(topVoterMessageIds.get(top), eb.build())
-					.queue(m -> plugin.getLogger()
-							.info("Edited Top Voters " + top.toString() + " (ID: " + topVoterMessageIds.get(top) + ")"),
-							err -> plugin.getLogger()
-									.warning("Error editing Top Voters" + top.toString() + ": " + err.getMessage()));
+			channel.editMessageEmbedsById(existingId, eb.build()).queue(
+					m -> plugin.debug("Edited Top Voters " + top + " (ID: " + existingId + ")"),
+					err -> plugin.getLogger().warning("Error editing Top Voters " + top + ": " + err.getMessage()));
 		}
 	}
 
+	/**
+	 * Sends a reward message to a Discord channel.
+	 *
+	 * @param message the message to send
+	 * @param channelId the Discord channel ID
+	 */
 	public void sendRewardMessage(String message, String channelId) {
 		TextChannel channel = DiscordUtil.getJda().getTextChannelById(channelId);
 		if (channel != null) {

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/PlayerPostVoteEvent.java

@@ -1,11 +1,13 @@
 package com.bencodez.votingplugin.events;
 
+import java.util.UUID;
+
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
 
-import com.bencodez.votingplugin.objects.VoteSite;
-import com.bencodez.votingplugin.proxy.BungeeMessageData;
+import com.bencodez.votingplugin.proxy.VoteTotalsSnapshot;
 import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
 import lombok.Getter;
 import lombok.Setter;
@@ -34,7 +36,7 @@ public class PlayerPostVoteEvent extends Event {
 
 	@Getter
 	@Setter
-	private BungeeMessageData bungeeTextTotals;
+	private VoteTotalsSnapshot bungeeTextTotals;
 
 	@Getter
 	@Setter
@@ -62,16 +64,50 @@ public class PlayerPostVoteEvent extends Event {
 
 	@Getter
 	@Setter
-	private VotingPluginUser votingPluginUser;
+	private boolean cached;
 
+	@Getter
+	@Setter
+	private String service;
+
+	@Getter
+	@Setter
+	private UUID uuid;
+	@Getter
+	@Setter
+	private String playerName;
+
+	@Getter
+	@Setter
+	private UUID voteUUID;
+
+	/**
+	 * Constructs a new PlayerPostVoteEvent.
+	 *
+	 * @param voteSite the vote site
+	 * @param user the voting plugin user
+	 * @param realVote whether this is a real vote
+	 * @param forceBungee whether to force Bungee processing
+	 * @param voteTime the vote timestamp
+	 * @param cached whether the vote was cached
+	 * @param service the service name
+	 * @param uuid the player UUID
+	 * @param playerName the player name
+	 * @param voteUUID the vote UUID
+	 */
 	public PlayerPostVoteEvent(VoteSite voteSite, VotingPluginUser user, boolean realVote, boolean forceBungee,
-			long voteTime) {
+			long voteTime, boolean cached, String service, UUID uuid, String playerName, UUID voteUUID) {
 		super(true);
 		this.user = user;
 		this.voteSite = voteSite;
 		this.realVote = realVote;
 		this.forceBungee = forceBungee;
 		this.voteTime = voteTime;
+		this.cached = cached;
+		this.service = service;
+		this.uuid = uuid;
+		this.playerName = playerName;
+		this.voteUUID = voteUUID;
 	}
 
 	/*

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/PlayerReceivePointsEvent.java

@@ -42,6 +42,12 @@ public class PlayerReceivePointsEvent extends Event {
 	@Setter
 	private String serviceSite = "";
 
+	/**
+	 * Constructs a new PlayerReceivePointsEvent.
+	 *
+	 * @param user the voting plugin user
+	 * @param points the points received
+	 */
 	public PlayerReceivePointsEvent(VotingPluginUser user, int points) {
 		super(true);
 		this.player = user;

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/PlayerSpecialRewardEvent.java

@@ -1,5 +1,7 @@
 package com.bencodez.votingplugin.events;
 
+import java.util.UUID;
+
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
 
@@ -38,10 +40,22 @@ public class PlayerSpecialRewardEvent extends Event {
 	@Setter
 	private VotingPluginUser user;
 
-	public PlayerSpecialRewardEvent(VotingPluginUser user, SpecialRewardType type) {
+	@Getter
+	@Setter
+	private UUID voteUUID;
+
+	/**
+	 * Constructs a new PlayerSpecialRewardEvent.
+	 *
+	 * @param user the voting plugin user
+	 * @param type the special reward type
+	 * @param voteUUID the vote UUID
+	 */
+	public PlayerSpecialRewardEvent(VotingPluginUser user, SpecialRewardType type, UUID voteUUID) {
 		super(true);
 		this.type = type;
 		this.user = user;
+		this.voteUUID = voteUUID;
 	}
 
 	/*

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/PlayerVoteCoolDownEndEvent.java

@@ -34,6 +34,11 @@ public class PlayerVoteCoolDownEndEvent extends Event {
 	@Setter
 	private VotingPluginUser player;
 
+	/**
+	 * Constructs a new PlayerVoteCoolDownEndEvent.
+	 *
+	 * @param user the voting plugin user
+	 */
 	public PlayerVoteCoolDownEndEvent(VotingPluginUser user) {
 		super(true);
 		player = user;

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/PlayerVoteEvent.java

@@ -3,9 +3,9 @@ package com.bencodez.votingplugin.events;
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
 
-import com.bencodez.votingplugin.objects.VoteSite;
-import com.bencodez.votingplugin.proxy.BungeeMessageData;
+import com.bencodez.votingplugin.proxy.VoteTotalsSnapshot;
 import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
 import lombok.Getter;
 import lombok.Setter;
@@ -38,7 +38,7 @@ public class PlayerVoteEvent extends Event {
 
 	@Getter
 	@Setter
-	private BungeeMessageData bungeeTextTotals;
+	private VoteTotalsSnapshot bungeeTextTotals;
 
 	@Getter
 	@Setter
@@ -84,6 +84,14 @@ public class PlayerVoteEvent extends Event {
 	@Setter
 	private int voteNumber = 1;
 
+	/**
+	 * Constructs a new PlayerVoteEvent.
+	 *
+	 * @param voteSite the vote site
+	 * @param voteUsername the username of the voter
+	 * @param serviceSite the service site name
+	 * @param realVote whether this is a real vote
+	 */
 	public PlayerVoteEvent(VoteSite voteSite, String voteUsername, String serviceSite, boolean realVote) {
 		super(true);
 		this.player = voteUsername;

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/PlayerVoteSiteCoolDownEndEvent.java

@@ -3,8 +3,8 @@ package com.bencodez.votingplugin.events;
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
 
-import com.bencodez.votingplugin.objects.VoteSite;
 import com.bencodez.votingplugin.user.VotingPluginUser;
+import com.bencodez.votingplugin.votesites.VoteSite;
 
 import lombok.Getter;
 import lombok.Setter;
@@ -39,6 +39,12 @@ public class PlayerVoteSiteCoolDownEndEvent extends Event {
 	@Setter
 	private VoteSite site;
 
+	/**
+	 * Constructs a new PlayerVoteSiteCoolDownEndEvent.
+	 *
+	 * @param user the voting plugin user
+	 * @param site the vote site
+	 */
 	public PlayerVoteSiteCoolDownEndEvent(VotingPluginUser user, VoteSite site) {
 		super(true);
 		player = user;

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/SpecialRewardType.java

@@ -0,0 +1,84 @@
+package com.bencodez.votingplugin.events;
+
+import lombok.Getter;
+
+/**
+ * Enumeration for different special reward types.
+ */
+public enum SpecialRewardType {
+	/** @deprecated All site reward. */
+	@Deprecated
+	ALLSITE, 
+	/** @deprecated Cumulative reward. */
+	@Deprecated
+	CUMMULATIVE, 
+	/** @deprecated First vote reward. */
+	@Deprecated
+	FIRSTVOTE, 
+	/** @deprecated First vote today reward. */
+	@Deprecated
+	FIRSTVOTETODAY, 
+	/** @deprecated Milestone reward. */
+	@Deprecated
+	MILESTONE, 
+	/** Vote streak reward. */
+	VOTESTREAK, 
+	/** @deprecated Almost all sites reward. */
+	@Deprecated
+	ALMOSTALLSITES, 
+	/** Top voter reward. */
+	TOPVOTER, 
+	/** Vote streaks reward. */
+	VOTESTREAKS;
+
+	@Getter
+	private int amount = -1;
+
+	@Getter
+	private String type = "";
+
+	/**
+	 * Sets the amount for this special reward.
+	 *
+	 * @param num the amount
+	 * @return this special reward type
+	 */
+	public SpecialRewardType setAmount(int num) {
+		amount = num;
+		return this;
+	}
+
+	/**
+	 * Sets the type for this special reward.
+	 *
+	 * @param type the type
+	 * @return this special reward type
+	 */
+	public SpecialRewardType setType(String type) {
+		this.type = type;
+		return this;
+	}
+
+	@Override
+	public String toString() {
+		StringBuilder sb = new StringBuilder(name());
+
+		if (amount >= 0) {
+			sb.append("(amount=").append(amount);
+		}
+
+		if (type != null && !type.isEmpty()) {
+			if (amount >= 0) {
+				sb.append(", ");
+			} else {
+				sb.append("(");
+			}
+			sb.append("type=").append(type).append(")");
+		} else if (amount >= 0) {
+			sb.append(")");
+		}
+
+		return sb.toString();
+	}
+
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/VoteMilestoneRewardEvent.java

@@ -0,0 +1,159 @@
+package com.bencodez.votingplugin.events;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+
+import org.bukkit.event.Event;
+import org.bukkit.event.HandlerList;
+
+import com.bencodez.votingplugin.specialrewards.votemilestones.VoteMilestone;
+import com.bencodez.votingplugin.user.VotingPluginUser;
+
+import lombok.Getter;
+
+/**
+ * Fired after a VoteMilestone reward has been executed successfully.
+ */
+public class VoteMilestoneRewardEvent extends Event {
+
+	private static final HandlerList HANDLERS = new HandlerList();
+
+	private final VotingPluginUser user;
+	private final UUID uuid;
+	private final String playerName;
+
+	private final VoteMilestone milestone;
+	private final long value;
+
+	private final String groupId;
+	private final String rewardPath;
+	@Getter
+	private final UUID voteUUID;
+	private final Map<String, String> placeholders;
+
+	/**
+	 * Constructs a new VoteMilestoneRewardEvent.
+	 *
+	 * @param user         VotingPluginUser who received the reward
+	 * @param milestone    milestone that triggered
+	 * @param value        resolved total value used for matching
+	 * @param groupId      resolved group id used for selection
+	 * @param rewardPath   path used to execute rewards
+	 * @param placeholders placeholders passed to the reward handler
+	 * @param voteUUID     UUID of the vote that triggered this reward (may be null)
+	 */
+	public VoteMilestoneRewardEvent(VotingPluginUser user, VoteMilestone milestone, long value, String groupId,
+			String rewardPath, Map<String, String> placeholders, UUID voteUUID) {
+		super(true);
+		this.user = user;
+		this.uuid = user == null ? null : user.getJavaUUID();
+		this.playerName = user == null ? null : user.getPlayerName();
+		this.milestone = milestone;
+		this.value = value;
+		this.groupId = groupId;
+		this.rewardPath = rewardPath;
+		this.voteUUID = voteUUID;
+		if (placeholders == null || placeholders.isEmpty()) {
+			this.placeholders = Collections.emptyMap();
+		} else {
+			this.placeholders = Collections.unmodifiableMap(new HashMap<>(placeholders));
+		}
+	}
+
+	/**
+	 * Gets the voting plugin user associated with this event.
+	 *
+	 * @return the voting plugin user
+	 */
+	public VotingPluginUser getUser() {
+		return user;
+	}
+
+	/**
+	 * Gets the player UUID.
+	 *
+	 * @return the player UUID
+	 */
+	public UUID getUuid() {
+		return uuid;
+	}
+
+	/**
+	 * Gets the player name.
+	 *
+	 * @return the player name
+	 */
+	public String getPlayerName() {
+		return playerName;
+	}
+
+	/**
+	 * Gets the milestone that triggered this event.
+	 *
+	 * @return milestone instance
+	 */
+	public VoteMilestone getMilestone() {
+		return milestone;
+	}
+
+	/**
+	 * Gets the milestone ID.
+	 *
+	 * @return milestone id string
+	 */
+	public String getMilestoneId() {
+		return milestone == null ? null : milestone.getId();
+	}
+
+	/**
+	 * Gets the value that triggered the milestone.
+	 *
+	 * @return the milestone value
+	 */
+	public long getValue() {
+		return value;
+	}
+
+	/**
+	 * Gets the group ID used for selection.
+	 *
+	 * @return group id string
+	 */
+	public String getGroupId() {
+		return groupId;
+	}
+
+	/**
+	 * Gets the configuration path for the rewards.
+	 *
+	 * @return the reward path
+	 */
+	public String getRewardPath() {
+		return rewardPath;
+	}
+
+	/**
+	 * Gets the placeholders map for this milestone reward.
+	 *
+	 * @return map of placeholder names to values
+	 */
+	public Map<String, String> getPlaceholders() {
+		return placeholders;
+	}
+
+	@Override
+	public HandlerList getHandlers() {
+		return HANDLERS;
+	}
+
+	/**
+	 * Gets the handler list for this event.
+	 *
+	 * @return handler list
+	 */
+	public static HandlerList getHandlerList() {
+		return HANDLERS;
+	}
+}

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/VotePartyEvent.java

@@ -28,6 +28,9 @@ public class VotePartyEvent extends Event {
 	@Setter
 	private boolean cancelled;
 
+	/**
+	 * Constructs a new VotePartyEvent.
+	 */
 	public VotePartyEvent() {
 		super(true);
 	}

VotingPlugin/src/main/java/com/bencodez/votingplugin/events/VoteShopPurchaseEvent.java

@@ -0,0 +1,51 @@
+package com.bencodez.votingplugin.events;
+
+import java.util.UUID;
+
+import org.bukkit.event.Event;
+import org.bukkit.event.HandlerList;
+
+import com.bencodez.votingplugin.user.VotingPluginUser;
+
+import lombok.Getter;
+
+/**
+ * Fired when a player attempts to purchase an item from VotingPlugin's
+ * VoteShop.
+ */
+public class VoteShopPurchaseEvent extends Event {
+
+	private static final HandlerList HANDLERS = new HandlerList();
+
+    @Getter
+	private UUID playerUuid;
+	@Getter
+	private String playerName;
+	@Getter
+	private VotingPluginUser user;
+
+	@Getter
+	private String identifier;
+
+	@Getter
+	private int cost;
+
+	public VoteShopPurchaseEvent(UUID playerUUID, String playerName, VotingPluginUser user, String identifier,
+			int cost) {
+		super(true);
+		this.playerName = playerName;
+		this.user = user;
+		this.playerUuid = playerUUID;
+		this.identifier = identifier;
+		this.cost = cost;
+	}
+
+	@Override
+	public HandlerList getHandlers() {
+		return HANDLERS;
+	}
+
+	public static HandlerList getHandlerList() {
+		return HANDLERS;
+	}
+}