Feat/permissions v2

.changelog/2.10.0.md

@@ -0,0 +1,12 @@
+# 2.10.0
+
+## API Changes
+- Implemented set api methods, which can be used to set the balance for accounts.
+```java
+  EconomyResponse set(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final BigDecimal amount);
+  EconomyResponse set(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final String worldName, @NotNull final BigDecimal amount);
+  EconomyResponse set(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final String worldName, @NotNull final String currency, @NotNull final BigDecimal amount);
+```
+
+# 2.13
+- Added support for 1.21.7

.changelog/2.14.md

@@ -0,0 +1,39 @@
+# 2.14
+- Added a few new methods for grabbing accounts that specific accounts have access to.
+```java
+
+    /**
+     * Retrieves a list of account IDs owned by the specified account ID.
+     *
+     * @param pluginName the name of the plugin
+     * @param accountID the unique identifier of the account
+     * @return a list of account names owned by the specified account ID
+     *
+     * @since 2.14
+     */
+    List<String> accountsOwnedBy(@NotNull final String pluginName, @NotNull final UUID accountID)
+
+    /**
+     * Retrieves a list of account IDs that the specified account is a member of.
+     *
+     * @param pluginName the name of the plugin
+     * @param accountID the UUID of the account to check membership for
+     * @return a List of String values representing the accounts that the account is a member of
+     *
+     * @since 2.14
+     */
+    List<String> accountsMemberOf(@NotNull final String pluginName, @NotNull final UUID accountID)
+
+    /**
+     * Retrieves a list of account IDs that the specified account has the specified permissions for.
+     *
+     * @param pluginName the name of the plugin
+     * @param accountID the UUID of the account to check access for
+     * @param permissions variable number of permissions to check for
+     * @return a list of accounts that the account has the specified permissions to
+     *
+     * @since 2.14
+     */
+    List<String> accountsAccessTo(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final AccountPermission... permissions)
+
+```

.changelog/2.15.md

@@ -0,0 +1,2 @@
+# 2.15
+- Added support for 1.21.7

.changelog/2.16.md

@@ -0,0 +1,2 @@
+# 2.16
+- Added support for 1.21.9

.changelog/2.17.md

@@ -0,0 +1,17 @@
+# 2.17
+- Added support for 1.21.10
+- Added clarity to documentation for default behavior if the provider doesn't support share accounts.
+- Added clarity to documentation for default behavior if the provider does not support multi-currency.
+- Added clarity to documentation for default behavior if the provider doesn't support multiple worlds.
+- Deprecated ```List<String> accountsAccessTo(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final AccountPermission... permissions)```
+  - This method will be removed in a future release as the string return allows ambiguity.
+- Deprecated ```List<String> accountsMemberOf(@NotNull final String pluginName, @NotNull final UUID accountID)```
+    - This method will be removed in a future release as the string return allows ambiguity.
+- Deprecated ```List<String> accountsOwnedBy(@NotNull final String pluginName, @NotNull final UUID accountID)```
+    - This method will be removed in a future release as the string return allows ambiguity.
+- Added ```List<UUID> accountsWithAccessTo(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final AccountPermission... permissions)```
+  - This method is a replacement for the now deprecated ```List<String> accountsAccessTo(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final AccountPermission... permissions)```
+- Added ```List<UUID> accountsWithMembershipTo(@NotNull final String pluginName, @NotNull final UUID accountID)```
+  - This method is a replacement for the now deprecated ```List<String> accountsMemberOf(@NotNull final String pluginName, @NotNull final UUID accountID)```
+- Added ```List<UUID> accountsWithOwnerOf(@NotNull final String pluginName, @NotNull final UUID accountID)```
+  - This method is a replacement for the now deprecated ```List<String> accountsOwnedBy(@NotNull final String pluginName, @NotNull final UUID accountID)```

.changelog/2.18.md

@@ -0,0 +1,5 @@
+# 2.18
+
+## API Changes
+- Revamped Permission API to include a modern permission API for VaultUnlocked specifically.
+- Revamped Chat API to include a modern chat API for VaultUnlocked specifically.

.changelog/2.9.0.md

@@ -0,0 +1,16 @@
+# 2.9.0
+
+## API Changes
+- Added standards for minimum Vault Unlocked Support. Projects that meet these standards may request
+  a review to use the badge associated with the API type(economy, etc) that they use.
+- Added balance methods in same format as the old getBalance methods.
+
+## Plugin Changes
+
+## Fixes
+
+## Deprecations
+- Deprecated getBalance methods, these are marked for removal in 3 releases. Use balance methods instead.
+- Deprecated createAccount methods without nonPlayer. Use the methods that include the nonPlayer parameter.
+
+## Removals

.changelog/template.md

@@ -0,0 +1,11 @@
+# Version
+
+## API Changes
+
+## Plugin Changes
+
+## Fixes
+
+## Deprecations
+
+## Removals

.github/ISSUE_TEMPLATE/request-a-feature.yml

@@ -0,0 +1,27 @@
+name: Feature Request
+description: Suggest a feature to be added in order to help Vault Unlocked improve.
+title: "[FEAT]: "
+labels: [ "feature" ]
+assignees:
+  - creatorfromhell
+
+body:
+  - type: markdown
+    attributes:
+      value: Thanks for helping to improve Vault Unlocked with feature requests!
+  - type: textarea
+    attributes:
+      label: Feature Description
+      description: Describe the feature you're requesting to be added here.
+      placeholder: |
+        Example: "Add a new method that gives everyone funds!"
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Reasoning
+      description: Why should this be added? What is the use-case?
+      placeholder: |
+        Example: "Global wealth!@#!@#!"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/request-badge-review.yml

@@ -0,0 +1,108 @@
+name: BADGE REVIEW
+description: Request a review of a project for a Vault Unlocked Support Badge.
+title: "[BADGE REVIEW]: "
+labels: [ "badge review" ]
+assignees:
+- creatorfromhell
+
+body:
+- type: dropdown
+  id: dropdown-1
+  attributes:
+      label: Badge Type
+      description: The type of badge that is being requested.
+      options:
+      - Economy
+      default: 0
+  validations:
+      required: true
+- type: input
+  id: input-2
+  attributes:
+      label: Project Name
+      description: The name of your project
+      placeholder: Example Project
+  validations:
+      required: true
+- type: input
+  id: input-3
+  attributes:
+      label: Project URL
+      description: The URL of your project.
+      placeholder: https://tnemc.net
+  validations:
+      required: true
+- type: input
+  id: input-4
+  attributes:
+      label: Source URL
+      description: The source of your project.
+      placeholder: https://github.com/TheNewEconomy/VaultUnlockedAPI
+  validations:
+      required: true
+
+### Economy Plugin Checklist
+
+- type: checkboxes
+  id: core-functionality
+  attributes:
+    label: Core Functionality
+    description: Implement all required functionality from the Economy interface.
+    options:
+      - label: "Fully implement all non-default methods from the Economy interface"
+        required: false
+      - label: "Implement boolean hasSharedAccountSupport()"
+        required: false
+      - label: "Implement boolean hasMultiCurrencySupport()"
+        required: false
+      - label: "Default to the base currency if multi-currency functionality is not supported"
+        required: false
+      - label: "Specify lack of multi-currency support on the project page or GitHub repository"
+        required: false
+
+- type: checkboxes
+  id: optional-features
+  attributes:
+    label: Optional Features
+    description: Implement optional shared account methods.
+    options:
+      - label: "Implement createSharedAccount(String pluginName, UUID accountID, String name, UUID owner)"
+        required: false
+      - label: I confirm that I have not read these checkboxes, so I just ticked them all.
+        required: false
+      - label: "Implement isAccountOwner(String pluginName, UUID accountID, UUID uuid)"
+        required: false
+      - label: "Implement addAccountMember(String pluginName, UUID accountID, UUID uuid, AccountPermission... permissions)"
+        required: false
+      - label: "Implement removeAccountMember(String pluginName, UUID accountID, UUID uuid)"
+        required: false
+      - label: "Implement hasAccountPermission(String pluginName, UUID accountID, UUID uuid, AccountPermission permission)"
+        required: false
+      - label: "Implement updateAccountPermission(String pluginName, UUID accountID, UUID uuid, AccountPermission permission, boolean value)"
+        required: false
+
+- type: checkboxes
+  id: user-plugin-methods
+  attributes:
+    label: Economy User Plugin Methods
+    description: Implement the required methods for Economy User Plugins.
+    options:
+      - label: "Implement balance(String pluginName, UUID accountID)"
+        required: false
+      - label: "Implement withdraw(String pluginName, UUID accountID, BigDecimal amount)"
+        required: false
+      - label: "Implement deposit(String pluginName, UUID accountID, BigDecimal amount)"
+        required: false
+
+- type: checkboxes
+  id: multi-currency-support
+  attributes:
+    label: Multi-Currency Support
+    description: Verify and document multi-currency support.
+    options:
+      - label: "Properly implement hasMultiCurrencySupport() and ensure it returns true if supported"
+        required: false
+      - label: "Provide functional implementation for currencies()"
+        required: false
+      - label: "Provide functional implementation for getDefaultCurrency(String pluginName)"
+        required: false

.github/workflows/gradle.yml

@@ -0,0 +1,49 @@
+# 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 Gradle
+
+on:
+  push:
+    branches:
+      - master
+      - main
+
+  pull_request:
+    branches:
+      - master
+      - main
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 21
+          cache: gradle
+
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Build with Gradle
+        run: ./gradlew build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: VaultUnlockedAPI
+          path: |
+            **/build/libs/*.jar

.github/workflows/javadoc.yml

@@ -0,0 +1,37 @@
+name: Deploy Javadoc
+
+on:
+  push:
+    branches:
+      - master
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write  # if you have a protection rule on your repository, you'll need to give write permission to the workflow.
+
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 21
+          cache: gradle
+
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Deploy JavaDoc 🚀
+        uses: MathieuSoysal/Javadoc-publisher.yml@v3.0.2
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          javadoc-branch: gh-pages
+          java-version: 21
+          target-folder: javadoc # url will be https://<username>.github.io/<repo>/javadoc, This can be left as nothing to generate javadocs in the root folder.
+          project: gradle

.github/workflows/maven.yml

@@ -15,24 +15,25 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
     - name: Set up JDK 1.8
-      uses: actions/setup-java@v1
+      uses: actions/setup-java@v3
       with:
-        java-version: 1.8
+        java-version: '8'
+        distribution: 'temurin'
     - name: Cache Maven packages
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.m2
         key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
         restore-keys: ${{ runner.os }}-m2
     - name: Build Release
       run: mvn -B package --file pom.xml
-    - name: Build javadoc
-      run: mvn -B javadoc:jar --file pom.xml
+    #- name: Build javadoc
+    #  run: mvn -B javadoc:jar --file pom.xml
     - name: Stage the artifact
       run: mkdir staging && cp target/*.jar staging
-    - uses: actions/upload-artifact@v2
+    - uses: actions/upload-artifact@v4
       with:
-        name: VaultAPI
+        name: VaultUnlockedAPI
         path: staging