ResourcesPlus 1.4.1 for NamelessMC 2.2.5
ResourcesPlus links forum discussions to resources for NamelessMC 2.2.5 and the samerton/Nameless-Resources 1.9.0 module, working similarly to the XenForo Resource Manager.
Main features
When a new resource is added, a new forum topic is created automatically in the forum configured for its category.
For each new release, the version number, title and release notes are posted as a reply in the same topic.
The Discuss tab appears directly after Overview with the same styling.
The linked forum topic shows a resource header at the top: icon, name, current version, short description and the full tab bar, with the Discuss tab active.
The target forum can be chosen per category, and the admin interface is available in English, Hungarian and German.
Existing resources and missed posts can be synchronized manually; running the sync repeatedly does not create duplicates.
LangPlus 1.7.0 compatibility: multilingual automatic posts are created using the !HU, !EN, !DE and !TITLE... markers.
What's new in 1.4.1
Automatic topic creation does not require the Create topic permission for the resource author. The target forum must still be configured, and the author must be able to see it. The opening post does not need reply permission either, but posting further releases does.
The new topic and its opening post receive the resource's original publication date, even when you synchronize manually at a later time. An old resource does not overwrite the forum's newer latest activity.
To fix the dates of earlier topics, enter the resource ID, tick the Also update the formatting of earlier automatic posts option and synchronize. Manually edited or deleted posts are not modified.
Requirements
NamelessMC 2.2.5 with the Forum module enabled, samerton/Nameless-Resources 1.9.0, PHP 8.2+, MySQL/MariaDB with PDO and InnoDB tables. The module uses the default nl2_ table names. Compatibility with other Resources forks or versions has not been verified.
Multilingual posts require LangPlus 1.7.0 to be installed and enabled, along with the PHP DOM extension. It also works without LangPlus.
Installation
Back up your website and database.
Copy the contents of the upload folder into the root directory of NamelessMC. Existing Resources or Forum files do not need to be modified.
StaffCP → Modules: install and then enable the ResourcesPlus module. The Forum and Resources modules must be installed and enabled first.
StaffCP → ResourcesPlus: assign a target forum to the desired Resources categories and save. Direct path: /panel/resources/discussions.
The resource author needs view permission in the target forum, and reply permission is also required for updates. Visitors must be able to see both the resource category and the forum topic to get the Discuss button.
Upload a test resource, publish an update for it, and check the opening topic, the new reply and the Discuss tab after Overview.
The admin group has access by default. Other staff members need the admincp.resources.discussions permission.
Synchronizing existing resources
At the bottom of the settings page, enter the resource ID (in /resources/resource/12-name/ it is 12) and click the Synchronize button.
If there is no linked topic yet, one is created with the current description and the version of the first release. Further releases become separate replies in chronological order, and already synchronized ones are skipped.
Automatic posting reacts to new uploads and releases published in the Resources module. A GitHub release must first be published in the Resources module as well.
Important operating details
Posts are created in the name of the resource author, and the opening topic title is [Resource] Resource name. The description is placed in a quote box, and long text can be expanded by clicking.
The module removes HTML formatting, keeps internal blank lines, shortens text that is too long, and links to the full resource.
Adjust the visibility of the target forum to match the resource category, because content copied to the forum is visible there according to the forum's own permissions.
It does not post to locked topics and does not recreate deleted topics. Changing the target forum does not move existing topics. When a resource is deleted, the discussion is kept, and editing a resource afterwards does not rewrite earlier forum posts.
A failed automatic post does not prevent the resource from being saved. The error appears in the PHP log marked [ResourcesPlus], and after fixing it the StaffCP synchronization fills in the missing posts.
Disabling and removal
The module can be disabled under StaffCP → Modules. Forum topics, posts and the three nl2_rd_* helper tables are kept. The helper tables (nl2_rd_categories, nl2_rd_topics, nl2_rd_releases) can be deleted separately after a backup, but this removes the duplicate protection.
The package is a standalone add-on and does not include the NamelessMC or Resources source.