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
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.
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.
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
- 1Click Create Studio on the dashboard. Name your studio and create the studio.
- 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.
- 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.
- 4Assign members to departments using the member picker in each department card.
- 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.
- 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.
- 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.
- 8At month-end: log revenue in Revenue, then go to Payouts to preview and run the payout cycle.
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
- 1Navigate to Projects in the studio nav (requires
project:view). - 2Click New Project. Enter a name and optional description.
- 3Once created, select the project from the list — its detail panel opens on the right.
- 4Add milestones to structure the work: click Add Milestone, give it a name and an optional target date.
- 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 detailsproject:createCreate new projectsproject:editEdit project name, description, milestonesproject:deleteArchive projectsTasks
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
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
Department
Priority
Assignees
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.
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 pipelinetask:createAdd new taskstask:editEdit any tasktask:deleteDelete taskstask:verifyApprove tasks in the queueHiring
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
Setting up hiring
- 1Go to Hiring in the studio nav (requires
hiring:manage). - 2On the Links tab, click Create Hiring Link. Enter a title, optional description, and select which group new members will join after acceptance.
- 3Copy the link URL and post it wherever you recruit. The link is permanent — it does not expire.
- 4When ready to accept applicants, click Open Applications. To pause hiring, click Close Applications.
- 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 stageshiring:interviewInterview access — view applicants, conduct interviews, add interview messagesPerformance 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
- 1Go to Insights → Reviews in the studio nav (requires
review:view). - 2Click New Review. Select the member and enter the review title and content.
- 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.
Permissions required
review:viewView reviews for all membersreview:manageCreate, edit, and delete manual reviewsPayouts
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
- 1Navigate to the Payouts tab in the studio nav (requires
payout:view). - 2Set the Period Start and Period End dates. These default to the current calendar month.
- 3Click Preview — a per-department, per-developer breakdown appears instantly. Review it carefully before committing.
- 4When satisfied, click Run & Persist (requires
payout:approve). The results are saved to the permanent ledger. - 5In the Unpaid ledger section, click Mark Paid for each developer after you have issued their Robux in-game.
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.
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
- 1Navigate to Revenue in the top studio nav (requires
workspace:settings). - 2Select the month and year using the dropdowns.
- 3Enter the total Robux earned for that month. Optionally add notes (e.g. "includes game-pass launch boost").
- 4Click Log Revenue. The entry is saved and appears in the bar chart.
- 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
- 1Go to Settings (requires
dept:manageorworkspace:settings). - 2Click New Department and enter a name.
- 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%.
- 4Use the member picker at the bottom of each department card to assign studio members to that department.
Payout weight
Member assignment
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
- 1Go to Groups & Perms in the studio nav (requires
group:view). - 2Click New Group to create a custom group. Give it a name, description, and a colour.
- 3With the group open, tick the permission tokens it should grant. Changes save immediately.
- 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
| Token | Category | What it unlocks |
|---|---|---|
| task:view | Tasks | See the task pipeline and all team tasks |
| task:create | Tasks | Add new tasks to the pipeline |
| task:edit | Tasks | Edit any task — title, description, assignees, priority, due date |
| task:delete | Tasks | Permanently delete tasks |
| task:verify | Tasks | Approve tasks in the verification queue (marks them Verified) |
| payout:view | Payouts | Access the Payouts page and the payout ledger |
| payout:approve | Payouts | Run payouts and mark ledger entries as paid |
| user:manage | Users | Invite and remove members, assign group membership |
| user:flag | Users | Flag a member for manager review |
| group:view | Groups | View permission groups and their token assignments |
| group:manage | Groups | Create, edit, and delete groups; change permissions |
| session:view | Sessions | See Team Status — who is online and active in Studio |
| workspace:settings | Studio | Access studio Settings, Revenue tracking, and config |
| dept:manage | Departments | Create and delete departments; assign members to them |
| plugin:deploy | Plugin | Access the studio deploy config in the Studio plugin |
| chat:delete | Chat | Delete any member's message in Team Chat |
| document:manage | Documents | Create, edit, and manage studio documents (rules, policies, NDA) and view who has acknowledged them |
| member:terminate | Members | Access the Fire Member page and remove members from the studio |
| review:view | Reviews | View performance reviews for studio members |
| review:manage | Reviews | Create, edit, and delete performance reviews |
Suggested custom group setups
Can verify teammate tasks and edit the pipeline, but cannot manage members or settings.
task:viewtask:createtask:edittask:verifysession:viewFull task and team oversight — can invite, remove, and flag members and manage departments.
task:viewtask:createtask:edittask:deletetask:verifyuser:manageuser:flagsession:viewdept:manageHandles payouts and revenue logging without touching tasks or team management.
payout:viewpayout:approveworkspace:settingsCan flag members and delete chat messages — useful for community managers.
user:flagchat:deletesession:viewMembers & 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.
- 1Go to Admin → Fire Member in the studio nav.
- 2Search for the member by name using the search box.
- 3Click Fire next to the member.
- 4Enter a reason (minimum 10 characters) — this is logged and sent to the member as a notification.
- 5Click Confirm Fire. Their access is removed immediately.
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
- 1Open Roblox Studio and click the Plugins tab in the ribbon.
- 2Click Manage Plugins, search for Plutana HR, and click Install.
- 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.
- 1Click your avatar (top-right of the Plutana HR web app) → Profile → click Generate to create your User Token.
- 2Click Show to reveal the full token, then copy it.
- 3Open Roblox Studio → click the Plutana HR toolbar button → paste your User Token and click Connect.
- 4The plugin reads
PluHR_ConfiginServerScriptServiceto detect your studio automatically. - 5Developer view opens: assigned tasks, session timer, and task status controls.
What the developer plugin shows
My Tasks
Session Timer
AFK Warning
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.
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
Period Stats
Team Overview
Pending Verification
Create Task
Studio Notice
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
Emoji reactions
Deleting messages
Message history
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
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
User Plugin Token
Sign Out
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.
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
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.
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.
Informational only
No action needed at all — just visible on the documents list for transparency.
Creating a document (Owners & HR)
- 1Go to your studio and click Documents in the top navigation bar (visible to all members).
- 2Click New Document and pick a starting point — a Non-Disclosure Agreement, Studio Rules, How Sanctions Work, How Payouts Work, or a Blank document.
- 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.
- 4Set the Grace period — how many days existing signers/acknowledgers have to re-confirm after a future update (default: 7 days).
- 5Toggle Enabled on to make it visible to members.
Templates
Each starter template fills in a full draft and a sensible default signature style — review and adjust before enabling.
Non-Disclosure Agreement
Studio Rules
How Sanctions Work
How Payouts Work
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
Roblox Username
Legal / Real Name
Age verification
Click-to-Accept
An Acknowledge-style document just needs a single "I've Read This" click — no personal fields, no scroll gate.
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)
Grace period: 1–365 days
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.