Getting Started

Plutana HR is a project management and team coordination platform. It combines project tracking, task management, hiring workflows, time tracking via the Roblox Studio plugin, and fair payout calculations into one unified studio.

How the platform works end-to-end

1

Organise work into projects

Create projects, break them into milestones, and assign tasks to your team. Progress is tracked automatically as tasks move through their lifecycle.

2

Managers track work on the web

The web dashboard shows real-time team status, verification queues, and hiring pipelines. Projects give a full master-detail view of each initiative.

3

Payouts are calculated fairly

At month-end, each developer's share is calculated from their verified tasks and active Studio time, then paid out from the department budget.

First-time setup sequence

  1. 1Click Create Studio on the dashboard. Name your studio and create the studio.
  2. 2Go to Settings → Invite Members. Select a permission group for new members, choose a link expiry, and click Generate Invite Link. Share the link with your team.
  3. 3Still in Settings, open the Departments section. Click New Department to create your teams (e.g. Scripters, Builders). Set a budget weight for each — these control how the payout pool is divided.
  4. 4Assign members to departments using the member picker in each department card.
  5. 5Go to Groups & Perms and configure permission groups. The three system groups (Owner, HR, Developer) are created automatically — customise or add more as needed. See the Permission Groups section for suggested setups.
  6. 6Create a Project from the Projects page. Add milestones to structure the work, then create tasks within the project and assign them to team members.
  7. 7If using Roblox Studio integration: have each developer go to their Profile (avatar top-right) → generate their User Token → open the Studio plugin, paste the token, and click Connect.
  8. 8At month-end: log revenue in Revenue, then go to Payouts to preview and run the payout cycle.
The studio owner automatically has full access to everything — you don't need to assign yourself to any permission group.

Projects

Projects are the top-level organisational unit. Each project contains milestones (phases of work) and tasks. The Projects page uses a master-detail layout — select a project from the list on the left to see its full detail view on the right.

Project detail view

Stats row

Shows total tasks, completed tasks, active tasks, and how many team members are formally assigned to the project.

Team

Members explicitly assigned to this project by managers (project:edit). Use Add Member to assign — and remove with the × on hover. Task Contributors below shows who has worked on tasks.

Tasks

The full list of tasks in this project, ordered by status (active first). Each row shows title, priority, status, assignees, and milestone.

Milestones

An accordion panel showing each milestone with a per-status task breakdown (Not Started, In Progress, Review, Completed, Verified). Click a milestone to expand it.

Creating a project

  1. 1Navigate to Projects in the studio nav (requires project:view).
  2. 2Click New Project. Enter a name and optional description.
  3. 3Once created, select the project from the list — its detail panel opens on the right.
  4. 4Add milestones to structure the work: click Add Milestone, give it a name and an optional target date.
  5. 5Create tasks via the Projects page or via any task creation flow. When creating a task, set its Project and Milestone to organise it.

Milestones

Milestones represent phases or deliverables within a project — for example, “Alpha Build”, “Beta Testing”, or “Launch”. Each milestone shows a summary of how many tasks are in each status, giving a quick progress read without opening individual tasks.

Target date

Optional deadline for the milestone. Shown alongside the milestone name for planning visibility.

Task counts

Backlog, Not Started, In Progress, Review, Completed, and Verified — all visible at a glance in the accordion.

Project status

Projects have a status (Active, On Hold, Completed, Archived) that is shown as a colour-coded badge in the project list. Archived projects are hidden by default — no tasks can be added to an archived project.

Permissions required

project:viewView projects and their details
project:createCreate new projects
project:editEdit project name, description, milestones
project:deleteArchive projects

Tasks

Tasks are the primary unit of work. Each task lives in a project and department, can have one or more assignees, and flows through a status pipeline. Completed and verified tasks directly drive each developer's payout share. Manage tasks from the Projects page — select a project to see and interact with its tasks.

Task lifecycle

Not Started
Task created but not yet picked up. Anyone with task:edit can move it to In Progress, or developers can claim it themselves.
In Progress
Actively being worked on. Any assignee can mark it Completed when the work is done.
Completed
Work submitted by the developer — sits in the verification queue. A manager reviews it before it counts toward payout.
Verified
Manager-approved. This status is permanent and counts toward the developer's payout score for the period. Requires task:verify permission.
Only Verified tasks count toward payout scores. Completed-but-unverified tasks do not contribute until a manager approves them.

Creating tasks

Navigate to Projects, select a project, and click New Task. A modal opens with a bulk-creation grid — you can add as many rows as you need in one go. Each row requires a title and a department; priority, milestone, and assignees are optional.

Title

Short description of the work to be done (up to 200 characters).

Department

Which team this task belongs to. Only active departments appear.

Priority

Low, Medium, High, or Critical — affects how tasks are visually sorted and highlighted.

Assignees

One or more members responsible for this task. Leave empty for an open task anyone can claim.

Multiple assignees & split pay

Tasks support multiple assignees. In the creation modal and the edit overlay, use the assignee picker to add as many team members as needed. Assignees are shown as chips — click the × on any chip to remove them.

In the task table, if a task has no assignees a + Claim button appears for members to self-assign. If a task already has assignees, a small join icon lets non-assigned members add themselves as co-assignees.

When a task has multiple assignees, the payout credit for that task is split equally among all of them. A task worth 100 points split between two developers gives each 50 points toward their payout score.

Editing tasks

In the project detail view, click any task row to open an edit panel showing title, description, assignees, priority, due date, status, and milestone. Save changes directly from the panel.

Verification workflow

When a developer marks a task Completed, it appears in the Verification Queue on the Dashboard. Managers with task:verify can click Verify to approve it from the dashboard — or navigate into the project to review it in context.

Permissions required

task:viewSee the task pipeline
task:createAdd new tasks
task:editEdit any task
task:deleteDelete tasks
task:verifyApprove tasks in the queue

Hiring

The Hiring system manages the full applicant journey — from the public application link through to onboarding as a studio member. Access it via the Hiring dropdown in the studio nav. Each studio has one permanent hiring link — HR and Owners can open or close applications at any time without changing the URL.

How the hiring link works

One permanent link

Each studio has a single, permanent application URL. Share it in Discord, your game description, or anywhere you recruit — it never expires.

Open / Close toggle

HR and Owners can open or close applications from the Hiring page. When closed, visitors see a "Applications are closed" message instead of the form.

Edit link details

The link title, description, and the group new members join can all be edited at any time via the pencil icon on the hiring link card.

Hiring pipeline stages

PendingApplicant has submitted the form. Their answers, Roblox username, and portfolio links are visible to HR.
InterviewMove a promising applicant to Interview. An interview thread opens where HR and the applicant can exchange messages directly.
ProbationAfter a successful interview, move them to Probation. They receive a studio invite link and begin a trial period before full membership.
AcceptedFinalise their membership. They are now a full studio member — assign them to a department and permission group. Application data is automatically deleted after 7 days.
RejectedClose out an application at any stage. Application data is automatically deleted after 7 days.

Setting up hiring

  1. 1Go to Hiring in the studio nav (requires hiring:manage).
  2. 2On the Links tab, click Create Hiring Link. Enter a title, optional description, and select which group new members will join after acceptance.
  3. 3Copy the link URL and post it wherever you recruit. The link is permanent — it does not expire.
  4. 4When ready to accept applicants, click Open Applications. To pause hiring, click Close Applications.
  5. 5Applicants appear in the Applications tab. Review and move them through the pipeline using the action buttons.

Applicant experience

Applicants can track their own application status from their Profile → Applications tab on the Plutana HR site. Each application card shows the current stage and links through to the interview thread. Application data (form answers, messages) is automatically deleted 7 days after the application is accepted or rejected.

Documents during onboarding

If your studio has any blocking documents enabled — an NDA, studio rules, or anything else — new members who join via a hiring invite are prompted to sign or acknowledge them before they can access any studio content. This is enforced automatically — no manual follow-up needed.

Permissions required

hiring:manageFull access — create the hiring link, open/close applications, view all applicants, move pipeline stages
hiring:interviewInterview access — view applicants, conduct interviews, add interview messages

Performance Reviews

Performance Reviews let managers record formal assessments for studio members. Reviews appear on each member's profile and are visible to members with thereview:view permission.

Review types

Manual

Written by a manager — a full text assessment. These can be edited or deleted after creation (owner approval required for deletion by non-owners).

Automated

Generated by the system at the end of a payout cycle. Includes task stats, verified count, and Studio time. Only the Owner can delete automated reviews.

Creating a review

  1. 1Go to Insights → Reviews in the studio nav (requires review:view).
  2. 2Click New Review. Select the member and enter the review title and content.
  3. 3Click Save — the review is saved immediately and visible to members with review:view.

Deleting a review

Members with review:manage can delete manual reviews they created. Automated reviews (system-generated) can only be deleted by the studio Owner. A confirmation is required before deletion.

Deleted reviews cannot be recovered. If you need to correct a manual review, edit it instead of deleting it.

Permissions required

review:viewView reviews for all members
review:manageCreate, edit, and delete manual reviews

Payouts

The payout system distributes Robux from each department's budget to developers based on their verified task performance and active Studio time within a selected period.

Payout formula in detail

For each developer in a department:

task_score = verified_tasks / total_dept_verified_tasks

time_score = active_minutes / max_active_minutes_in_dept

raw_score = (task_weight × task_score) + (time_weight × time_score)

payout = (raw_score / sum_all_raw_scores) × dept_budget_robux

task_weight + time_weight always equal 1. Both are configurable in Settings → Studio Settings. The default is 50% / 50%.

Payout formula slider (Settings)

In Settings → Studio Settings, the Payout Formula slider controls how much weight is given to tasks vs Studio time. Drag left for more Studio-time emphasis, drag right for more task emphasis. The two percentages always sum to 100%.

Running a payout — step by step

  1. 1Navigate to the Payouts tab in the studio nav (requires payout:view).
  2. 2Set the Period Start and Period End dates. These default to the current calendar month.
  3. 3Click Preview — a per-department, per-developer breakdown appears instantly. Review it carefully before committing.
  4. 4When satisfied, click Run & Persist (requires payout:approve). The results are saved to the permanent ledger.
  5. 5In the Unpaid ledger section, click Mark Paid for each developer after you have issued their Robux in-game.
Running payouts twice for the same period creates duplicate ledger entries. Always preview first and run only once per period. The total payout never exceeds the sum of all department budgets — there is no risk of overpaying.

Payout ledger

The ledger at the bottom of the Payouts page shows a permanent record of every payout run. Filter by status (Unpaid / Paid) or by department. Each entry shows the developer, department, period, their raw score, and exact Robux amount. Once marked as paid, entries are locked.

Department budgets and weights

Each department has a payout weight (configured in Settings → Departments). The studio's total monthly revenue is split among departments proportionally to their weights. Weights should sum to 100% — the settings page will warn you if they don't.

If a department had zero verified tasks and zero Studio time in the period, its budget goes to the owner's excess pool — it is not rolled over to the next month.

Revenue

The Revenue page is where you log your studio's monthly Robux earnings. Logged revenue feeds into the payout calculation — the monthly figure is multiplied by each department's weight to determine the department budget for that cycle.

Logging revenue

  1. 1Navigate to Revenue in the top studio nav (requires workspace:settings).
  2. 2Select the month and year using the dropdowns.
  3. 3Enter the total Robux earned for that month. Optionally add notes (e.g. "includes game-pass launch boost").
  4. 4Click Log Revenue. The entry is saved and appears in the bar chart.
  5. 5To update a previously logged month, select the same month/year, enter the corrected amount, and submit again — it overwrites the previous entry.

Reading the chart

The bar chart shows the last 12 months at a glance. Hover over a bar to see the exact Robux amount. The current month is highlighted in green. Months with no logged revenue appear as empty bars.

Departments

Departments represent the distinct teams within your studio — for example, Scripters, Builders, UI Designers, or QA. Every member must be in a department to receive payouts. New studios start with no departments — you create them yourself.

Creating departments

  1. 1Go to Settings (requires dept:manage or workspace:settings).
  2. 2Click New Department and enter a name.
  3. 3Once created, set a Payout Weight — this is a percentage that controls how much of the total revenue pool this department receives. All department weights should add up to 100%.
  4. 4Use the member picker at the bottom of each department card to assign studio members to that department.

Payout weight

Controls how much of the monthly revenue pool this department receives. If Scripters have a weight of 60% and Builders 40%, a ₹10,000 Robux month gives Scripters ₹6,000 and Builders ₹4,000 to distribute.

Member assignment

A member can belong to only one department at a time. Assigning them to a new department removes them from the old one. Members with no department receive no payout.
If a department has zero verified tasks and zero Studio time in a period, its budget is not distributed — it goes to the owner's excess pool. Set realistic budgets for the expected contribution of each team.

Deleting departments

Click the trash icon on a department card. Members assigned to the deleted department are unassigned — reassign them manually. Tasks that belonged to the department are also deleted.

Permission Groups

Permission Groups control what each member can see and do in Plutana HR. Every member inherits the combined permissions of all groups they belong to. Studio owners always have full access regardless of group membership.

System groups

Six system groups are created automatically when a studio is made. They cannot be renamed or deleted:

Owner

Full access to everything. Automatically assigned to the studio creator.

HR

Management-level access: tasks, payouts, members, groups, settings, and departments. Assign to senior managers.

Lead Developer

Task management, team oversight, and payout preview. Suited for project leads who need to verify work and see analytics.

Senior Developer

Can verify tasks and edit the pipeline but cannot manage members or settings.

Developer

Basic access: task view, session view, and review view. The default starting point for new team members.

Probation Developer

Minimal access for members on trial. They can view tasks and their own profile but cannot interact with management features.

Managing groups

  1. 1Go to Groups & Perms in the studio nav (requires group:view).
  2. 2Click New Group to create a custom group. Give it a name, description, and a colour.
  3. 3With the group open, tick the permission tokens it should grant. Changes save immediately.
  4. 4Add members to the group via the member picker. Members can be in multiple groups — they receive the union of all their groups' permissions.

All permission tokens

TokenCategoryWhat it unlocks
task:viewTasksSee the task pipeline and all team tasks
task:createTasksAdd new tasks to the pipeline
task:editTasksEdit any task — title, description, assignees, priority, due date
task:deleteTasksPermanently delete tasks
task:verifyTasksApprove tasks in the verification queue (marks them Verified)
payout:viewPayoutsAccess the Payouts page and the payout ledger
payout:approvePayoutsRun payouts and mark ledger entries as paid
user:manageUsersInvite and remove members, assign group membership
user:flagUsersFlag a member for manager review
group:viewGroupsView permission groups and their token assignments
group:manageGroupsCreate, edit, and delete groups; change permissions
session:viewSessionsSee Team Status — who is online and active in Studio
workspace:settingsStudioAccess studio Settings, Revenue tracking, and config
dept:manageDepartmentsCreate and delete departments; assign members to them
plugin:deployPluginAccess the studio deploy config in the Studio plugin
chat:deleteChatDelete any member's message in Team Chat
document:manageDocumentsCreate, edit, and manage studio documents (rules, policies, NDA) and view who has acknowledged them
member:terminateMembersAccess the Fire Member page and remove members from the studio
review:viewReviewsView performance reviews for studio members
review:manageReviewsCreate, edit, and delete performance reviews

Suggested custom group setups

Senior Developer

Can verify teammate tasks and edit the pipeline, but cannot manage members or settings.

task:viewtask:createtask:edittask:verifysession:view
Team Lead

Full task and team oversight — can invite, remove, and flag members and manage departments.

task:viewtask:createtask:edittask:deletetask:verifyuser:manageuser:flagsession:viewdept:manage
Finance

Handles payouts and revenue logging without touching tasks or team management.

payout:viewpayout:approveworkspace:settings
Moderator

Can flag members and delete chat messages — useful for community managers.

user:flagchat:deletesession:view

Members & Firing

The Member Context Menu (right-click any member card on the dashboard) gives quick access to common member actions without navigating away. The options shown depend on your permissions.

Context menu actions

View Profile

Always visible. Opens the full member profile page — contribution history, reviews, and group membership.

Change Group

Requires user:manage. Move the member to a different permission group in a small modal.

Flag Member

Requires user:flag. Mark a member for manager review. Flagged members appear highlighted in the admin panel. Click Flag again to remove.

Fire Member

Requires member:terminate. Opens a confirmation modal with a required reason field (min 10 characters). The action immediately removes their studio access.

Firing a member

Members with member:terminate can access the Admin → Fire Member page. It lists all active members — excluding yourself and the studio owner, who cannot be removed this way.

  1. 1Go to Admin → Fire Member in the studio nav.
  2. 2Search for the member by name using the search box.
  3. 3Click Fire next to the member.
  4. 4Enter a reason (minimum 10 characters) — this is logged and sent to the member as a notification.
  5. 5Click Confirm Fire. Their access is removed immediately.
Firing is permanent — the member must be re-invited via a new hiring link to rejoin. The studio owner cannot be fired through this page.

Permissions required

member:terminateAccess the Fire Member page and remove members.

Studio Plugin

The Plutana HR Studio Plugin runs inside Roblox Studio. It tracks each developer's active editing time, shows their assigned tasks, and lets them update task status without leaving Studio.

Installing the plugin

  1. 1Open Roblox Studio and click the Plugins tab in the ribbon.
  2. 2Click Manage Plugins, search for Plutana HR, and click Install.
  3. 3A Plutana HR toolbar button will appear in Studio.

Plugin V1.2 — User TokenCurrent

V1.2 uses a single User Token that works across all your studios. The correct studio is auto-detected from the PluHR_Config ModuleScript in ServerScriptService.

  1. 1Click your avatar (top-right of the Plutana HR web app) → Profile → click Generate to create your User Token.
  2. 2Click Show to reveal the full token, then copy it.
  3. 3Open Roblox Studio → click the Plutana HR toolbar button → paste your User Token and click Connect.
  4. 4The plugin reads PluHR_Config in ServerScriptService to detect your studio automatically.
  5. 5Developer view opens: assigned tasks, session timer, and task status controls.

What the developer plugin shows

My Tasks

Lists all tasks assigned to you in the current studio. Shows title, priority, and current status. You can move In Progress tasks to Completed directly from here.

Session Timer

Shows how long your current Studio session has been active and counts time only when you are actively scripting (keystrokes in the script editor). Camera movement alone does not count.

AFK Warning

If you stop interacting for several minutes the plugin shows an AFK warning. Your session is auto-frozen after the configured timeout and stops accumulating time.

How time tracking works

V1.2 tracks time via script editor keystrokes — every time you type in the script editor, a heartbeat is sent to Plutana HR. Sessions are auto-closed after 15 minutes with no heartbeat. Active seconds are accumulated per session and used in the payout calculation at month-end.

HTTP requests must be enabled in Studio: File → Game Settings → Security → Allow HTTP Requests. Without this, heartbeats cannot reach the Plutana HR API.

Plugin V1 — Studio TokenDeprecated

V1 tokens still work but will not receive new features. Migrate to V1.2 by generating a User Token on your Profile page.

Owner Dashboard (Plugin)

The Roblox account registered as the studio owner sees a different view in the Studio plugin — the Owner Dashboard. Members with plugin:deploy who are not the owner are routed to the standard developer view.

Owner Dashboard features

▶ Deploy to Studio

Writes the PluHR_Config ModuleScript directly into ServerScriptService in one click. Creates the script if it is missing, overwrites it silently if it exists. Keep your studio token private — anyone who has it can submit sessions as your studio.

Period Stats

Live snapshot of the current payout cycle: total active Studio hours, task counts by status (Not Started / In Progress / Completed / Verified), active member count, total Robux revenue, and days remaining in the cycle. Also shows the current studio notice.

Team Overview

Lists all active members with a live status indicator (Online / Idle / Offline), their period hours, verified task count, and estimated Robux payout. Click Remove to deactivate a member mid-cycle — their metrics are frozen at that point and carried into the end-of-month payout.

Pending Verification

Tasks marked Completed by developers appear here for quick review. Click ✓ Verify to approve — the task is stamped Verified and counts toward the developer's payout score. Same gate as the web verification queue but accessible in Studio.

Create Task

Create and assign a task without leaving Studio. Enter a title, pick a department, optionally assign it to a specific member, and set a priority. The task appears immediately in the web task pipeline.

Studio Notice

Post a short announcement visible to all developers in their plugin view. Useful for sprint goals, meeting reminders, or status updates. Click Clear to remove the current notice. The notice also appears in the Period Stats card.

Team Chat

Team Chat is a studio-scoped channel visible to all members. It's accessible from the studio nav. Use it for quick team-wide announcements, sprint updates, or coordination.

Chat features

Sending messages

Type in the input at the bottom and press Enter or click Send. Messages support plain text and appear in reverse-chronological order (newest first).

Emoji reactions

Hover over any message and click the emoji button to react. Click a reaction to toggle your own reaction on and off. Reaction counts are shown inline.

Deleting messages

You can always delete your own messages. Members with the chat:delete permission can delete any member's message — useful for moderation.

Message history

The chat loads the 50 most recent messages on open. Scroll to the top to load older messages in batches.
Chat is studio-scoped — messages are not shared across studios. There is no direct messaging between members.

Team Status

The Team Status panel on the studio dashboard shows a real-time presence overview of every member. It requires the session:view permission.

Presence indicators

Studio (green)Member is actively editing in Roblox Studio with a recent plugin heartbeat.
Website (cream)Member has the Plutana HR web app open in a browser tab (refreshes every 60 seconds).
Studio + WebsiteMember is active in both Studio and the web app simultaneously.
AFK (amber)Member has a Studio session open but has not typed in the script editor recently. Session is about to be frozen.
Offline (gray)No active Studio session and no web presence within the last 2 minutes.

Session time display

For members with an active Studio session, the panel shows their total active seconds for the current session in hours/minutes (e.g. 2h 15m). This accumulates only while they are actively typing in the script editor.

Flagging members

Members with user:flag can click the flag icon on any member card to flag them for manager review. Flagged members appear highlighted in the admin panel. Click the flag again to remove it.

Your Profile

The Profile page is accessed by clicking your avatar or username in any navigation bar. It has two tabs — Profile and Applications — and requires no studio permissions.

Profile tab

Profile info

Your Roblox avatar, display name, username, and Roblox ID — pulled directly from Roblox and kept in sync automatically.

User Plugin Token

A single token that identifies you across all studios — used with Plugin V1.2. Click Show to reveal the full token and copy it. Click Regenerate Token to invalidate the old one and get a new one — you will need to reconnect in Studio after regenerating.

Sign Out

Signs you out of Plutana HR in your current browser. Your Studio plugin session remains active until the next heartbeat timeout (~15 minutes).

Applications tab

The Applications tab shows every hiring application you have submitted across all studios, with live status updates. Click any application card to open the interview thread for that application.

Pending ReviewYour application has been received and is awaiting review by the studio HR team.
In InterviewHR has moved you to the interview stage. Check the interview thread for messages.
ProbationYou have passed the interview and are on a trial period. You should have received an invite to the studio.
AcceptedYou are a full studio member. This card will disappear 7 days after acceptance.
Not SelectedThis application was not taken forward. You are welcome to apply again when applications re-open.

Document System

The Document System lets studio Owners and HR create any number of documents — a real NDA, studio rules, an explainer on how sanctions work, or anything else — and decide how much ceremony each one needs. A real legal agreement can require a full signature; most other documents just need a one-click acknowledgment, or nothing at all if they're purely informational.

Three signature styles

Sign

Full legal signature

Discord username, Roblox username, legal name, and age confirmation, plus a scroll-to-read gate. Reserved for a real NDA or similarly binding document.

Ack

One-click acknowledge

A single "I've Read This" button — no personal details collected. Used for studio rules, policy explainers, and anything else that's a courtesy read rather than a legal signature.

Info

Informational only

No action needed at all — just visible on the documents list for transparency.

Any of the three styles can also be set to block entry — members must complete it before accessing the rest of the studio — independently of how heavy the signing process is. A lightweight studio-rules document can block entry just as an NDA can, without forcing the full legal form on everyone.

Creating a document (Owners & HR)

  1. 1Go to your studio and click Documents in the top navigation bar (visible to all members).
  2. 2Click New Document and pick a starting point — a Non-Disclosure Agreement, Studio Rules, How Sanctions Work, How Payouts Work, or a Blank document.
  3. 3You're taken to the document's page. Open Document Management to review and edit the generated text, choose its signature style, and decide whether it blocks entry.
  4. 4Set the Grace period — how many days existing signers/acknowledgers have to re-confirm after a future update (default: 7 days).
  5. 5Toggle Enabled on to make it visible to members.
Once enabled with Blocks entry on, every member who hasn't completed it — including existing members — will be redirected to it the next time they visit any studio page. Make sure the text is final before enabling.

Templates

Each starter template fills in a full draft and a sensible default signature style — review and adjust before enabling.

Non-Disclosure Agreement

A real legal NDA, assembled from pre-written clause blocks (IP ownership, confidentiality, non-compete, and more) personalised with your studio name. Defaults to full signature + blocks entry. Not legal advice — review before enabling.

Studio Rules

Lightweight ground rules — respect, communication, platform guidelines. Defaults to one-click acknowledge + blocks entry.

How Sanctions Work

Explains warnings, strikes, and suspensions in plain language — including that only a suspension has any real, automatic effect. Defaults to acknowledge, doesn't block entry by default.

How Payouts Work

A draft outline of the monthly payout cycle. Defaults to informational only — review and finish the copy before publishing to your studio.

Signing or acknowledging (Developers)

When a document blocks entry and you haven't completed it yet, you'll be redirected to it the next time you visit any studio page. A Sign-style document shows the same fields as a legal agreement always has:

Discord Username

Your Discord handle as used in the team server (e.g. jake_rd).

Roblox Username

Pre-filled from your account. Editable if needed.

Legal / Real Name

Your full real name — required for a signature to be legally binding. Kept strictly confidential. Only HR and Owners can see it.

Age verification

Confirm whether you're 18 or older, or under 18 with a parent/guardian's consent.

Click-to-Accept

A mandatory checkbox confirming you agree to the full terms. Unlocks only after you've scrolled through the entire document text.

An Acknowledge-style document just needs a single "I've Read This" click — no personal fields, no scroll gate.

During onboarding, any number of acknowledge-mode blocking documents are combined into one checklist step — a link to the documents list and a single required checkbox — instead of visiting each one separately. A real sign-mode NDA still gets its own dedicated step, since a blanket checkbox can't substitute for an actual signature.

Version updates & grace periods

If an Owner or HR member updates a document's text, the system stamps a new version date. Existing signers/acknowledgers are considered valid for the duration of the configured grace period (default: 7 days). After the grace period expires, members who acted on the old version are prompted to act again.

New members (or anyone who hasn't completed it at all) must always act on the current version immediately.

Grace period: 0 days (immediate)

Setting the grace period to 0 invalidates all existing acknowledgments the moment a new version is saved. Every member — including those who already completed it — must act again before accessing any studio page (if it blocks entry). Use this when the content has changed significantly and you need immediate compliance.

Grace period: 1–365 days

Existing signers/acknowledgers continue to have valid access for the number of days you set. Once the window expires, they're redirected to act again. The amber dot on the Documents nav link warns members before their acknowledgment expires.
Clicking Force Re-acknowledge bumps a document's version immediately. If grace is set to 0, every member loses access right away (if it blocks entry). Make sure the text is saved and final before forcing a re-acknowledgment.

Viewing acknowledgments

On a document's page, the Acknowledgments tab is visible to members with thedocument:manage permission. For a Sign-style document it shows each member's Discord username, Roblox username, age status, and the date they signed — legal names are hidden by default, click the eye icon next to a name to reveal it. Acknowledge-style documents show just the member and date.

Each row shows one of three statuses:

Current (green)

The member has acted on the current version. No action needed.

Re-ack pending (amber)

The document was updated and this member acted on a previous version. They're still within the grace period and have valid access — but they'll need to act again before it expires.

Re-ack required (red)

The grace period has expired. This member is blocked from studio access until they act on the current version (if it blocks entry).

Permission required

document:manageCreate, edit, and manage documents; view who has acknowledged them. Granted to Owner by default.

Troubleshooting

Plugin errors

"Invalid token"

Your User Token was regenerated on the Profile page. Go to Profile → Show → copy the new token → reconnect in Studio.

"Studio not found"

You are no longer an active member of this studio. Contact a studio manager to be re-added.

"Studio config not found"

The PluHR_Config ModuleScript is missing from ServerScriptService. Ask the studio owner to click ▶ Deploy to Studio in the Owner Dashboard, or manually create a ModuleScript named PluHR_Config in ServerScriptService.

"Access Denied"

Your Plutana account is not a member of this studio. Contact a studio manager.

Seeing developer view instead of Owner Dashboard

The Owner Dashboard is only shown to the Roblox account that owns the studio. Check you are signed into the correct Roblox account in Studio.

Heartbeat not registering / time not accumulating

HTTP requests must be enabled in Studio: File → Game Settings → Security → Allow HTTP Requests. Also ensure you are actively typing in the script editor — V1.2 tracks keystrokes, not camera movement.

Session frozen immediately

Your AFK timeout was reached. Click the button in the plugin to resume your session. Make sure to stay active in the script editor.

Payout issues

Developer shows 0 Robux in preview

They had no verified tasks AND no Studio time in the selected period. Check that tasks were verified (not just Completed) and that their plugin was connected and active.

Department shows 0% allocation

No members in the department had any verified tasks or Studio time. The department's budget goes to the owner excess pool for this cycle.

Payout weights don't sum to 100%

Go to Settings → Departments and adjust the payout weights until the total shown at the bottom reads 100%.

Ran payouts twice by mistake

Duplicate entries are now in the ledger. You can mark the duplicate entries as paid without actually paying them, or contact your platform admin.

Studio and member issues

Invite link not working

The link may have expired. Generate a new one in Settings → Invite Members. Also check that the invitee is a member of the linked Roblox group if group-gating is enabled.

Member cannot see a feature

Check their group membership in Groups & Perms. Add them to a group with the required permission token. Remember: owners always have full access.

Cannot delete a department

Departments can be deleted by members with dept:manage. Note: this also deletes all tasks assigned to that department. Reassign members manually after deletion.

Still stuck?

If you're experiencing a platform issue not covered here, contact your studio owner or a Plutana HR administrator. Owners can request an admin override from the dashboard to get temporary elevated access for debugging.