V5.4.0-rc1 to master

.github/workflows/autoclose.yml

@@ -0,0 +1,24 @@
+name: Close issues due to author inactivity
+on:
+  schedule:
+    - cron: "30 15 * * 6"
+
+jobs:
+  close-issues:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/stale@v8
+        with:
+          only-labels: "Status: Needs Author Input"
+          days-before-issue-stale: 30
+          days-before-issue-close: 90
+          stale-issue-label: "Status: Stale"
+          stale-issue-message: "Hey there @ ${{ github.event.issue.user.login }} , we want to express our appreciation for your initial contribution to this issue. However, we now mark it as stale since we haven't received any response from you in the past 30 days. If you're still available, we would greatly appreciate it if you could provide answers to any open questions and/or share the requested feedback/input. Thank you for your consideration, we hope to hear from you soon!"
+          close-issue-message: "Hey there @ ${{ github.event.issue.user.login }} , we want to express our appreciation for your initial contribution to this issue. However, we now mark it as closed since we haven't received any response from you in the past 90 days. If you're still available, we would greatly appreciate it if you could provide answers to any open questions and/or share the requested feedback/input. Thank you for your consideration, we hope to hear from you soon!"
+          close-issue-reason: "not_planned"
+          days-before-pr-stale: -1
+          days-before-pr-close: -1
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/project-autoadd.yml

@@ -0,0 +1,61 @@
+name: Auto Assign to Projects
+
+on:
+  issues:
+    types: [opened, labeled]
+  pull_request:
+    types: [opened, labeled]
+
+jobs:
+  add_opened_to_inbox_board:
+    name: Add New Issue/PR to Terasology Inbox Board
+    if: github.event.action == 'opened'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Add to inbox board
+        uses: actions/add-to-project@v0.3.0
+        with:
+          project-url: 'https://github.com/orgs/MovingBlocks/projects/26'
+          github-token: ${{ secrets.PROJECT_GITHUB_TOKEN }}
+  add_bug_labeled_to_bug_board:
+    name: Assign bug report issues and pull requests to bug board backlog
+    if: |
+      contains(github.event.issue.labels.*.name, 'Type: Bug') ||
+      contains(github.event.pull_request.labels.*.name, 'Type: Bug')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Add to bug board
+        uses: actions/add-to-project@v0.3.0
+        with:
+          project-url: 'https://github.com/orgs/MovingBlocks/projects/29'
+          github-token: ${{ secrets.PROJECT_GITHUB_TOKEN }}
+  add_maintenance_to_stabilization_board:
+    name: Assign stabilization / refactoring / chore issues and pull requests to stabilization board backlog
+    if: |
+      github.event.action != 'opened' && 
+      ( contains(github.event.issue.labels.*.name, 'Type: Refactoring') ||
+      contains(github.event.pull_request.labels.*.name, 'Type: Refactoring') ||
+      contains(github.event.issue.labels.*.name, 'Type: Chore') ||
+      contains(github.event.pull_request.labels.*.name, 'Type: Chore') ||
+      contains(github.event.issue.labels.*.name, 'Topic: Stabilization') && !contains(github.event.issue.labels.*.name, 'Type: Bug') ||
+      contains(github.event.pull_request.labels.*.name, 'Topic: Stabilization') && !contains(github.event.pull_request.labels.*.name, 'Type: Bug') )
+    runs-on: ubuntu-latest
+    steps:
+      - name: Add to stabilization board
+        uses: actions/add-to-project@v0.3.0
+        with:
+          project-url: 'https://github.com/orgs/MovingBlocks/projects/25'
+          github-token: ${{ secrets.PROJECT_GITHUB_TOKEN }}
+  add_features_to_feature_board:
+    name: Assign improvement issues and pull requests to feature board backlog
+    if: |
+      github.event.action != 'opened' && 
+      contains(github.event.issue.labels.*.name, 'Type: Improvement') && !contains(github.event.issue.labels.*.name, 'Topic: Stabilization') ||
+      contains(github.event.pull_request.labels.*.name, 'Type: Improvement') && !contains(github.event.pull_request.labels.*.name, 'Topic: Stabilization')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Add to feature board
+        uses: actions/add-to-project@v0.3.0
+        with:
+          project-url: 'https://github.com/orgs/MovingBlocks/projects/27'
+          github-token: ${{ secrets.PROJECT_GITHUB_TOKEN }}

.gitignore

@@ -16,7 +16,6 @@
 extensions
 /facades/*
 !/facades/PC
-!/facades/TeraEd
 !/facades/subprojects.gradle
 /modules/*
 !/modules/subprojects.gradle

Jenkinsfile

@@ -12,7 +12,9 @@ properties([
     // that can't simply be turned off
     copyArtifactPermission('*'),
     // Flag for Jenkins to discard attached artifacts after x builds
-    buildDiscarder(logRotator(artifactNumToKeepStr: artifactBuildsToKeep))
+    buildDiscarder(logRotator(artifactNumToKeepStr: artifactBuildsToKeep)),
+    // configure Jenkins to abort a build if a new one is triggered for the same branch
+    disableConcurrentBuilds(abortPrevious: true)
 ])
 
 /**
@@ -34,7 +36,7 @@ properties([
 
 pipeline {
     agent {
-        label 'ts-engine && heavy && java11'
+        label 'ts-engine && heavy && java17'
     }
     stages {
         // declarative pipeline does `checkout scm` automatically when hitting first stage
@@ -119,7 +121,7 @@ pipeline {
 
         stage('Analytics') {
             steps {
-                sh './gradlew --console=plain check -x test'
+                sh './gradlew --console=plain check -x test -x pmdMain -x pmdTest -x pmdJmh' // TODO: Probably more cleanly remove PMD overall if no use?
             }
             post {
                 always {
@@ -138,8 +140,7 @@ pipeline {
 
                     recordIssues(skipBlames: true, enabledForFailure: true,
                         tools: [
-                            spotBugs(pattern: '**/build/reports/spotbugs/*.xml', useRankAsPriority: true),
-                            pmdParser(pattern: '**/build/reports/pmd/*.xml')
+                            spotBugs(pattern: '**/build/reports/spotbugs/*.xml', useRankAsPriority: true)
                         ])
 
                     recordIssues(skipBlames: true, enabledForFailure: true,
@@ -157,7 +158,7 @@ pipeline {
             }
         }
 
-        stage('Integration Tests') {
+        stage('Integration Tests (without flaky tests)') {
             steps {
                 sh './gradlew --console=plain integrationTest'
             }
@@ -175,5 +176,26 @@ pipeline {
                 }
             }
         }
+
+        stage('Integration Tests (flaky tests only)') {
+            steps {
+                warnError("Integration Tests Failed") {  // if this errs, mark the build unstable, not failed.
+                    sh './gradlew --console=plain integrationTestFlaky'
+                }
+            }
+            post {
+                always {
+                    // Gradle generates both a HTML report of the unit tests to `build/reports/tests/*`
+                    // and XML reports to `build/test-results/*`.
+                    // We need to upload the XML reports for visualization in Jenkins.
+                    //
+                    // See https://docs.gradle.org/current/userguide/java_testing.html#test_reporting
+                    junit testResults: '**/build/test-results/integrationTestFlaky/*.xml', allowEmptyResults: true
+                    // Jenkins truncates large test outputs, so archive it as well.
+                    tar file: 'build/integrationTestFlaky-results.tgz', archive: true, compress: true, overwrite: true,
+                        glob: '**/build/test-results/integrationTestFlaky/*.xml'
+                }
+            }
+        }
     }
 }

README.md

@@ -3,30 +3,34 @@
     <a href="https://github.com/MovingBlocks/Terasology/releases/latest">
         <img src="https://img.shields.io/github/release/MovingBlocks/Terasology.svg" alt="Release" />
     </a>
-    <a href="http://www.apache.org/licenses/LICENSE-2.0">
+    <a href="https://www.apache.org/licenses/LICENSE-2.0">
         <img src="https://img.shields.io/badge/license(code)-Apache%202.0-blue.svg" alt="License (Code)" />
     </a>
-    <a href="http://creativecommons.org/licenses/by/4.0/">
+    <a href="https://creativecommons.org/licenses/by/4.0/">
         <img src="https://img.shields.io/badge/license(art)-CC%20BY%204.0-blue.svg" alt="License (Art)" />
     </a>
-    <a href="https://lgtm.com/projects/g/MovingBlocks/Terasology/alerts/">
-        <img src="https://img.shields.io/lgtm/alerts/g/MovingBlocks/Terasology.svg?logo=lgtm&logoWidth=18" alt="LGTM Alerts" />
+    <a href="https://codeclimate.com/" target="_blank" alt="Code climate">
+        <img src="https://img.shields.io/codeclimate/maintainability/MovingBlocks/Terasology" alt="Code climate maintainability" />
     </a>
-    <a href="https://lgtm.com/projects/g/MovingBlocks/Terasology/context:java">
-        <img src="https://img.shields.io/lgtm/grade/java/g/MovingBlocks/Terasology.svg?logo=lgtm&logoWidth=18" alt="Java Grade" />
+    <a href="https://codeclimate.com/" target="_blank" alt="Code climate" >
+        <img src="https://img.shields.io/codeclimate/tech-debt/MovingBlocks/Terasology" alt="Code climate tech debt" />
+    </a>
+     <a href="https://codeclimate.com/" target="_blank" alt="Code climate">
+        <img src="https://img.shields.io/codeclimate/issues/MovingBlocks/Terasology" alt="Code climate issues" />
     </a>
 </div>
 
 <h3 align="center"><b>
     <a href="#community">Community</a> | 
     <a href="#installation">Installation</a> | 
     <a href="#development">Development</a>  | 
-    <a href="#license">License</a> 
+    <a href="#license">License</a> |
+    <a href="https://terasology.org/Terasology/#/">Knowledge Base</a>
 </b></h3>
 
 The _Terasology_ project was born from a Minecraft-inspired tech demo and is becoming a stable platform for various types of gameplay settings in a voxel world.
-The [creators and maintainers](https://github.com/MovingBlocks/Terasology/blob/develop/docs/Credits.md) are a diverse mix of software developers, designers, game testers, graphic artists, and musicians. We encourage others to join!
-We encourage contributions from anybody and try to keep a warm and friendly community and maintain a [code of conduct](docs/CODE_OF_CONDUCT.md).
+The [creators and maintainers](https://github.com/MovingBlocks/Terasology/graphs/contributors) are a diverse mix of software developers, designers, game testers, graphic artists, and musicians. We encourage others to join!
+We encourage contributions from anybody and try to keep a warm and friendly community and maintain a [code of conduct](.github/CODE_OF_CONDUCT.md).
 
 ## Community
 
@@ -48,7 +52,7 @@ We are present in nearly the complete round-up of social networks. Follow/friend
         <img src="./docs/images/facebook.png" width="48px"/>
     </a>
     &nbsp;&nbsp;&nbsp;&nbsp;
-    <a title="Reddit" href="http://www.reddit.com/r/Terasology">
+    <a title="Reddit" href="https://www.reddit.com/r/Terasology">
         <img src="./docs/images/reddit.png" width="48px"/>
     </a>
     &nbsp;&nbsp;&nbsp;&nbsp;
@@ -65,7 +69,6 @@ We are present in nearly the complete round-up of social networks. Follow/friend
     </a>
 </p>
 
-
 ## Installation
 
 <table>
@@ -104,16 +107,16 @@ We are present in nearly the complete round-up of social networks. Follow/friend
 
 Internet connectivity is required for downloading Terasology via the Launcher, afterwards playing offline is possible.
 
-For easy game setup (recommended) you can use our launcher - [download it here](https://terasology.org/download.html).
+For easy game setup (recommended) you can use our launcher - [download it here](https://terasology.org/downloads/).
 
 For more information about playing, like hot keys or server hosting, see the [dedicated page](docs/Playing.md) or check out the [modules](docs/Modules.md).
 
 
 ### Alternative Installation Methods
 
-If you already have a Java Development Kit (JDK) installed, you may use a direct download release as an alternative to using the [launcher](https://github.com/MovingBlocks/TerasologyLauncher/releases). Java version 11 is required.
+If you already have a Java Development Kit (JDK) installed, you may use a direct download release as an alternative to using the [launcher](https://github.com/MovingBlocks/TerasologyLauncher/releases). Java version 17 is required.
 
-Direct download stable builds are uploaded to [our release section here on GitHub](https://github.com/MovingBlocks/Terasology/releases) while the cutting-edge develop version can be downloaded direct [here from our Jenkins](https://jenkins.terasology.io/teraorg/job/Terasology/job/Omega/job/master/lastSuccessfulBuild/artifact/distros/omega/build/distributions/TerasologyOmega.zip).
+ßDirect download stable builds are uploaded to [our release section here on GitHub](https://github.com/MovingBlocks/Terasology/releases) while the cutting-edge develop version can be downloaded direct [here from our Jenkins](https://jenkins.terasology.io/job/Terasology/job/Omega/job/develop/lastSuccessfulBuild/artifact/distros/omega/build/distributions/TerasologyOmega.zip).
 
 
 ## Development
@@ -123,7 +126,7 @@ Development is possible on all common platforms (Windows, Linux, MacOS) as long
 ### Requirements
 
 Technical Requirements:
-- Java SE Development Kit (JDK) 11. The CI will verify against this baseline version.
+- Java SE Development Kit (JDK) 17. The CI will verify against this baseline version.
   <br>Using newer Java versions may cause issues (see [#3976](https://github.com/MovingBlocks/Terasology/issues/3976)).
 - Git to clone the repo and commit changes.
 
@@ -134,8 +137,8 @@ Non-Technical Requirements:
 ### Workspace Setup
 
 To be able to run **Terasology** from source, you'll need to setup your workspace.
-Follow the [Contributor Quick Start Guide](https://github.com/MovingBlocks/Terasology/wiki/Contributor-Quick-Start).
-This guide is designed for [IntelliJ IDEA](http://www.jetbrains.com/idea/) (you can use the free community edition), but alternative setups are possible.
+Follow the [Contributor Quick Start Guide](https://terasology.org/Terasology/#/Contributor-Quick-Start).
+This guide is designed for [IntelliJ IDEA](https://www.jetbrains.com/idea/) (you can use the free community edition), but alternative setups are possible.
 
 > :warning: _Note, that a Terasology workspace is a **multi-repo workspace**._
 
@@ -144,17 +147,16 @@ While your workspace itself is a clone of [MovingBlocks/Terasology](https://gith
 Accordingly, if you want to contribute to modules, you'll need to navigate into the respective subdirectory and work with Git from in there.
 Any Git commands executed in your workspace root will target [MovingBlocks/Terasology](https://github.com/MovingBlocks/Terasology).
 
-For more information, see our wiki entry on [Understanding Terasology's Git Setup](https://github.com/MovingBlocks/Terasology/wiki/Developing-Modules#understanding-terasologys-git-setup).
+For more information, see our wiki entry on [Understanding Terasology's Git Setup](https://terasology.org/Terasology/#/Developing-Modules?id=understanding-terasology39s-git-setup).
 
 
 ### Contributing
 
-Detailed information on how to contribute can be found in [CONTRIBUTING.md](./.github/CONTRIBUTING.md). Remember, that all submissions must be licensed under [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
+Detailed information on how to contribute can be found in [CONTRIBUTING.md](.github/CONTRIBUTING.md). Remember, that all submissions must be licensed under [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).
 
 Terasology has a rather steep learning curve in the beginning.
-To help you with the learning process, our [Adventure Site](https://terasology.org/AdventureSite/#/) helps you find the resources you need according to the field of contribution you're interested in.
-
-Additional learning resources can be found in our [wiki](https://github.com/MovingBlocks/Terasology/wiki) and our [tutorial modules](https://github.com/Terasology?q=Tutorial&type=all&language=&sort=).
+To help you with the learning process, our [Terasology Knowledge Base](https://terasology.org/Terasology/#/), formerly known as the Terasology Engine wiki, helps you find the resources you need according to the field of contribution you're interested in.
+Additional learning resources can be found in our [tutorial modules](https://github.com/Terasology?q=Tutorial&type=all&language=&sort=).
 
 If you find errors or issues in any of our resources, please report them using GitHub issues and help fix them.
 
@@ -164,4 +166,4 @@ Developers with previous experience in rendering, physics and other less trivial
 
 ## License
 
-Terasology is fully open source and licensed [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0) for code and [Creative Commons Attribution License, Version 4.0](http://creativecommons.org/licenses/by/4.0/) for artwork (unless indicated otherwise - see credits for minor exceptions).
+Terasology is fully open source and licensed [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0) for code and [Creative Commons Attribution License, Version 4.0](https://creativecommons.org/licenses/by/4.0/) for artwork (unless indicated otherwise - see credits for minor exceptions).