Releases: FIRST-Tech-Challenge/scorekeeper
FIRST Tech Challenge Live v5.0.9
CENTERSTAGE Official Release
This version can be used for official events and contains the following fixes:
- Fixes League Rankings on the Match Preview screen
- Update control page Score Edit tab to match order on paper scoresheets
The latest version of the scoring system can be downloaded from https://ftc-scoring.firstinspires.org/local/2024
Details
- Fixes League Rankings when shown on the Match Preview Screen
- Only appears when "Show Event Ranking in addition to League Rankings" is checked
- Move Autonomous pixel counts above the robot-specific task table
- Move Drones below End Game Navigation.
- Fix warning appearing on PDF scoresheets on the Resources page
FIRST Tech Challenge Live v5.0.8
CENTERSTAGE Official Release
This version can be used for official events and contains the following bugfix:
- Fixes FTA Notes
The latest version of the scoring system can be downloaded from https://ftc-scoring.firstinspires.org/local/2024
Details
- Fixes FTA Notes
- FTA notes can now be saved
FIRST Tech Challenge Live v5.0.7
CENTERSTAGE Official Release
This version can be used for official events and contains the following improvements:
- Adds CENTERSTAGE animations when showing results
- Adds new optional "Volunteer Award" to tournament-level events
- Adds new banner that appears when using unsupported browsers
The latest version of the scoring system can be downloaded from https://ftc-scoring.firstinspires.org/local/2024
Details
- Adds new optional "Volunteer Award" to tournament-level events
- Like the Judges' Award, this award can have a customized name and description at each event
- This award can be given to more than one volunteer at the event
- Adds new banner that appears when using unsupported browsers
- If you use the scoring system from an unsupported browser, you will see a message like this one (as shown in the screenshot, Safari is not supported on computers, though it is supported on iPads/iPhones):
- While things may partially work in an unsupported browser, if you contact support or file a bug while using an unsupported browser, we will require that you try a supported browser instead.
Bug Fixes
- Fixes issues scanning QR codes with the most recent versions of the FTC SDK
- Fixes manually added resources not being accessible
- Fixes fields getting stuck if a team is marked as not present after their team prop has been selected
- Fix live support chat intermittently disconnecting and failing to upload images
FIRST Tech Challenge Live v5.0.6
CENTERSTAGE Preview Release # 2
This is a preview release of the FIRST Tech Challenge Scoring Software for CENTERSTAGE. THIS VERSION CANNOT BE USED FOR OFFICIAL EVENTS.
Reminder: The CENTERSTAGE scoring system has auto-updates. If you have already installed the scoring system this season, just open it while connected to the internet to download the latest version. (If it is already running you will need to exit it first.)
Notable changes:
- Teams can now be marked as "no show" or "robot not present" (was in the first preview but not documented)
- Overlay now supports "transparent" backgrounds
- CENTERSTAGE inspection forms and scoresheets have been added
- Head Referee features no longer require enabling on the Settings tab
The latest version of the scoring system can be downloaded from https://ftc-scoring.firstinspires.org/local/2024
Details
- Teams can now be marked as "no show" or "robot not present" (was in the first preview but not documented)
- A team marked as "no robot" cannot have robot-specific achievements scored but will earn RP/TBP the same as a team that is present: this should be used for teams that have a member present for the match but no robot on the field. This should reduce scoring errors where a team with no robot but a team member present is inadvertently marked as a "no show" (which does not earn RP/TBP).
- Overlay now supports "transparent" backgrounds
- If you select "transparent" for the overlay color, the layer underneath will be shown without needing to use a chroma/color key. This is only useful with OBS/other software-based switchers; if you are using a conventional video switcher you will need to continue using color-based keying. The overlay will default to transparent mode when opened inside OBS browser.
- CENTERSTAGE inspection forms and scoresheets have been added
- The randomization display now shows the Backdrop position in addition to the Spike Mark position
- Head Referee features no longer require enabling on the Settings tab
- Head Referee features are now always available without being separately enabled first. They are still optional, and all aspects of the event will work correctly without them.
Bug Fixes
- The overlay color picker is now usable
- "Very Late" for inspection status displays has been changed to be a different color from "not started"
- Fixes typo in Alliance Selection script* Clicking the scoring system link in the launcher will now always open a single copy of the scoring system in a browser
- n the launcher will now always open a single copy of the scoring system in a browsers
- The "Drone Zone" inputs have been reorganized to make clearer that either team's drone can be entered into ether input
- Referees can no longer submit scores at the end of the match if there is an error in their data. An error message will be shown indicating which field needs correcting.
- Use of a Team Prop is more visibly indicated on audience displays
FIRST Tech Challenge Live v5.0.1
CENTERSTAGE Preview Release
This is a preview release of the FIRST Tech Challenge Scoring Software for CENTERSTAGE. THIS VERSION CANNOT BE USED FOR OFFICIAL EVENTS.
Notable new features:
- Cloud-based Scoring Calculator
- New installation method, with autoupdate
- Brand new display designs
- QR Code Login
- Interactive alliance selection script for emcees
- Inspection status on regular displays
- Elimination brackets on pit displays
- Pit map in traditional scoring system
- Match observer report
- Wifi channel assignment
The latest version of the scoring system can be downloaded from https://ftc-scoring.firstinspires.org/local/2024
Details
- Cloud-based Scoring Calculator
- The calculator is available at https://ftc-scoring.firstinspires.org/scoreCalculator
- This is intended to facilitate strategy discussion and drive practice for teams without needing to download and configure the full traditional scoring system
- The calculator is not for use at events
- New installation method, with autoupdate
- The system should now be downloaded from https://ftc-scoring.firstinspires.org/local/2024 (previous seasons will remain available on github releases)
- The scoring system is now installed, rather than a ZIP you unpack
- Databases are now stored in
Documents/FIRST Tech Challenge Live/<season>
- Databases are now stored in
- You only need to download and install the scoring system once per computer per season. When you launch the scoring system, it will automatically download any updates that are available if it is connected to the internet.
- The website will detect the platform you are running on and offer a button to download for that platform
- If you need to download for one system from another (e.g. the scoring computer runs Windows but you are downloading on a Mac to put on a flash drive), other systems can be found by clicking on "All platforms"
- While running, the scoring system will now show a splash screen instead of a terminal window:
- To shut down the scoring system, close this window or click the Exit button.
- For additional information, see https://github.com/FIRST-Tech-Challenge/scorekeeper/wiki/FTC-Live-Installers
- Brand new display designs
- Interactive alliance selection script for emcees
- A new generated role has been created (
{event}_mc
) that can run alliance selection in coordination with the scorekeeper - The scorekeeper must still start alliance selection at the start and generate matches at the end
- This feature is optional, and the scorekeeper can continue to enter teams for alliance selection as they have in past seasons. The match control page and MC page will remain in sync if both are being used together
- A new generated role has been created (
- QR Code Login
- Elimination brackets on pit displays
- As soon as alliance selection is completed and elimination matches are generated, the pit displays will show the bracket. Match results will be 30 seconds delayed after committing to allow time to post results to the audience first.
- Pit map in traditional scoring system
- The pit map building is the same as what has existed in ftc-scoring previously
- Pit map updates will sync in real time between ftc-scoring and the local scoring system
- Match observer report
- A printable match observer report can now be generated, with one page per team following the format from the judge advisor manual.
- Wifi Channel Assignment
- Teams can now be assigned to wifi channels from the event dashboard, which is checked automatically if using QR code inspection. This also generates a printable report
Additional small changes:
- Event "reload"
- On the "Manage Server" page, you can now "reload" an individual event. This is equivalent to restarting the scoring system, but only for a single event. This is primarily useful for dual division events, where you can restart one division without restarting the other. (This can fail, in which case you will still need to restart the scoring system.)
- Dual-division events now have an option to show all three layers of the elimination bracket on displays and reports
- Configurable parameters on reports (e.g. compact) persist if the page is reloaded
- "Require referee interaction" has been restored
- This setting makes all referee inputs start blank and will not allow referees to submit without filling in an entry for each input
- Match schedules can now be printed directly from the schedule generation page
- When using an overlay, the match preview and randomization will always be overlay sized; there is no longer a configuration option for those.
FIRST Tech Challenge Live v4.3.4_OFFSEASON
This is the POWERPLAY Offseason build of the scoring system. As in previous seasons, several restrictions have been lifted for offseason events and some extra features are added to help with some non-standard event flows:
Offseason-only Features
- Cyan banner to indicate OFFSEASON build
- Allows custom match schedule
- Removes match count restriction
- Reserve teams 99990-99999 for Offseason use
- Syncing of data to ftc-events.firstinspires.org will work for Offseason Events registered through the Offseason Event Notice and approved in the Online Scoring System.
Note: VMS integration will not be available - The Event Admin will need to manually add anyone that needs access to the Online Scoring System through the event's "Add User" page. This would include any judges or scorekeepers.
General Release Notes
- Event "reload"
- On the "Manage Server" page, you can now "reload" an individual event. This is equivalent to restarting the scoring system, but only for a single event. This is primarily useful for dual division events, where you can restart one division without restarting the other. (This can fail, in which case you will still need to restart the scoring system.)
- Dual-division events now have an option to show all three layers of the elimination bracket on displays and reports
- Match Observer Report
- A printable match observer report can now be generated, with one page per team following the format from the judge advisor manual.
- Add pit map builder to event dashboard, printable pit map report, and inspection status presented on pit maps
- The pit map building is the same as what has existed in ftc-scoring for much of this season
- Pit map updates will sync in real time between ftc-scoring and the local scoring system
- Show the elimination bracket on pit displays
- As soon as alliance selection is completed and elimination matches are generated, the pit displays will show the bracket. Match results will be 30 seconds delayed after committing to allow time to post results to the audience first.
- Wifi Channel Assignment
- Teams can now be assigned to wifi channels from the event dashboard, which is checked automatically if using QR code inspection. This also generates a printable report
- Configurable parameters on reports (e.g. compact) persist if the page is reloaded
Instructions for Offseason Events
This workflow is for Hybrid and Traditional Offseason Events. For Remote Offseason Events see the note at the bottom of the release.
- Either submit an OffSeason Event Notice or have your PDP request the event in the Online Scoring System using the "Event Request" feature from the Region Admin page. Please do this as soon as possible! Once the event has been approved, make sure your PDP grants you Event Admin access to the Event via the "Add User" button on the Event Dashboard.
- If the event is Hybrid - the event request is required. If your event is Traditional, the request is strongly recommended
- Add your teams to the event in the Online Scoring System
- If you are running a Traditional Offseason Event & are allowing "B-Teams" or other unregistered Teams to compete, assign each one a number between 99990 and 99999 and add them to the event as that number. In the Online Scoring System, they will appear as "Offseason Demo Team". You can rename them upon import to the Traditional Scoring System.
- Hybrid Events may add teams 99990-99999, but they will not be able to participate in judging. Online Judging is restricted to teams registered before the end of the season.
- Import the event into the Offseason Traditional Scoring Software using one of the 3 standard import methods.
- On the "Create Match Schedule" page, you can specify any number of matches and run MatchMaker, or you can import a csv with a schedule. To import a csv, we recommended generating a dummy schedule and then exporting it as a template and editing it. There are NO validations of ANYTHING when a custom schedule is imported. See below for additional info.
- Run your event, and submit results to FIRST as usual.
Please see the Off-Season Event Guidelines for additional information
Creating a Custom Schedule
From the Match Schedule Generation page, the system can now export the current schedule. This will download a csv
file that is formatted properly to import back into the system:
We recommend generating a schedule, exporting it, and then editing that schedule to import back in to the system. However, MatchMaker cannot generate a schedule with fewer than 4 teams. In that case, please use the example table below, which you can paste into a spreadsheet-editor and then edit and save as a .csv
file.
NOTE: This allows for the generation of schedules that would otherwise not be possible. For example, the same Team could be on both Red and Blue Alliance. Because of this, custom schedules may lead to unexpected results with the Qualification Rankings.
Date (mm/dd/yyyy) | Start Time (24hr hh:mm) | Match # or Break | Red 1 or Break Text | Red 2 | Blue 1 | Blue 2 |
---|---|---|---|---|---|---|
6/10/2020 | 9:05 | 1 | 1111 | 2222 | 3333 | 4444 |
6/10/2020 | 9:12 | Break | 5 minute break | |||
6/10/2020 | 9:17 | 2 | 2222 | 3333 | 1111 | 4444 |
Alternatively, you can directly edit the CSV shown below:
Date (mm/dd/yyyy),Start Time (24hr hh:mm),Match # or Break,Red 1 or Break Text,Red 2,Blue 1,Blue 2
6/10/2020,9:05,1,1111,2222,3333,4444
6/10/2020,9:12,Break,5 minute break,,,
6/10/2020,9:17,2,2222,3333,1111,4444
Surrogate Teams can be denoted by appending a *
to the end of their number in the schedule.
Notes for Offseason Remote Events:
- Events must be registered in the Online Scoring System using the "Event Request" feature.
- The only non-standard configuration supported is the number of matches per team may be set to any number larger than or equal to 6.
- The Awards Display will not show matches > 6, but they will all count towards rankings and will appear on ftc-events.firstinspires.org
- Refer to additional guidance sent from HQ to PDPs for more details about Remote Offseason events.
FIRST Tech Challenge Live v4.2.6
This is a REQUIRED update for dual-division events as it fixes a bug where the Match Control page can become frozen & unusable during inter-division finals.
Note on the freezing control page bug for in-progress DD events that do not wish to update post-import:
This bug is non-deterministic, so it is not a guarantee that it will be hit. If the control page becomes unresponsive, close any displays not on the finals/parent division (*_0
), including pit & sponsor displays, then refresh the control page.
Important Notes for the POWERPLAY season
- The referee & scorekeeper inputs are from the SCORING SIDE perspective (BEHIND THE FIELD). Make sure your scoring referees are on the scoring side of the field.
- Referees are scoring a side of the field, not an Alliance. They enter the scoring state for both red and blue on their half of the field. The X Junction column is entered by both referees, and both must agree.
- The Junction edit popup on the Match Control page is alliance-agnostic. Edits to junctions affect both alliances.
- The displays show a grid that indicates ownership of junctions & circuits. It is oriented to match the configuration of the display. The standard configuration will display the grid from the Audience perspective. This is opposite the referee and scorekeeper! A display that is configured for "Red on Left" will display the grid from the scoring perspective. Be sure to set this configuration properly for streams where the camera is behind the field.
- With the MatchMaker update in v4.1.6, some Windows users may see a "Security scan required" notification when you run MatchMaker. MatchMaker should continue to run properly during or after the scan. If you run into problems generating a qualification schedule, please contact support. Do not attempt a DIY solution for a schedule generation issue.
Detailed Change Log
- Fixes bug where the match control page can freeze if there are displays from different divisions present when the video switch tab is opened.
- Fix control page behavior during referee review - control page will see live updates properly.
- Fix circuit rendering bug that was sometimes not picking shortest path
- Fix Match Control's total score when a Red Card is earned in eliminations (The same bug where it showed penalty points as the total instead of 0 has also been fixed on FTC-Events)
FIRST Tech Challenge Live v4.2.3
This release fixes several bugs and adds a few small improvements. See the Detailed Change Log for details.
Important Notes for the POWERPLAY season
- The referee & scorekeeper inputs are from the SCORING SIDE perspective (BEHIND THE FIELD). Make sure your scoring referees are on the scoring side of the field.
- Referees are scoring a side of the field, not an Alliance. They enter the scoring state for both red and blue on their half of the field. The X Junction column is entered by both referees, and both must agree.
- The Junction edit popup on the Match Control page is alliance-agnostic. Edits to junctions affect both alliances.
- The displays show a grid that indicates ownership of junctions & circuits. It is oriented to match the configuration of the display. The standard configuration will display the grid from the Audience perspective. This is opposite the referee and scorekeeper! A display that is configured for "Red on Left" will display the grid from the scoring perspective. Be sure to set this configuration properly for streams where the camera is behind the field.
- With the MatchMaker update in v4.1.6, some Windows users may see a "Security scan required" notification when you run MatchMaker. MatchMaker should continue to run properly during or after the scan. If you run into problems generating a qualification schedule, please contact support. Do not attempt a DIY solution for a schedule generation issue.
Detailed Change Log
- Fixes bug where MatchMaker could run multiple times at once and result in bad Match times.
- Don't populate schedule in reports until activated. The only exception is the Schedule report, which is used to print the schedule.
- As a reminder, the "Activate Quals Schedule" step is to allow time to print schedules before it is public. NEVER RUN MATCHMAKER BEFORE ALL TEAMS HAVE PASSED ALL INSPECTIONS!
- Fix Circuit/Ownership changes leaking when one ref is in review and the other is not. This should fix circuit paths being rendered through un-owned Junctions.
- Fix bug where the bracket would not show when one semifinal had completed and the other had not.
- Show signal zone on HR page (in brackets on the Navigation line)
- Fix bug where Compass Award Display showed "null null"
- Fix Dual-Division nav-bar dropdown menus
- Attempts to fix missing audio issues
- Allows naming of Displays. The name will appear on the Video Switch tab's Connected Displays list
- Dual Division parent division (
_0
) control page lists all connected displays for all divisions - Fix local translations
- Fix some support chat bugs
FIRST Tech Challenge Live v4.2.1
This update fixes several bugs and makes user interface improvements. This update is strongly recommended for all events. If you have already set up your event for this week, it is not required to update, but be aware of the bugs this fixes and the workarounds listed on the announcement currently up on ftc-scoring.firstinspires.org.
Important Notes for the POWERPLAY season
- The referee & scorekeeper inputs are from the SCORING SIDE perspective (BEHIND THE FIELD). Make sure your scoring referees are on the scoring side of the field.
- Referees are scoring a side of the field, not an Alliance. They enter the scoring state for both red and blue on their half of the field. The X Junction column is entered by both referees, and both must agree.
- The Junction edit popup on the Match Control page is alliance-agnostic. Edits to junctions affect both alliances.
- The displays show a grid that indicates ownership of junctions & circuits. It is oriented to match the configuration of the display. The standard configuration will display the grid from the Audience perspective. This is opposite the referee and scorekeeper! A display that is configured for "Red on Left" will display the grid from the scoring perspective. Be sure to set this configuration properly for streams where the camera is behind the field.
- With the MatchMaker update in v4.1.6, some Windows users may see a "Security scan required" notification when you run MatchMaker. MatchMaker should continue to run properly during or after the scan. If you run into problems generating a qualification schedule, please contact support. Do not attempt a DIY solution for a schedule generation issue.
Detailed Change Log
- Referee "wait for start" page shows the selections from init
- Fix bug where QR link to ftc-events results would render poorly
- Fix HR page freezing on 2nd referee submit
- Unmuted field display will no longer play timeout sounds if the other field is running match
- Fix bug where referee scores would not clear on abort
- Fix bug where a semifinal replay that changes outcome would result in the wrong alliance shown in finals
- Fix support chat bug on newer JDKs.
- Fix match commit when in sandbox mode
FIRST Tech Challenge Live v4.2.0
This update fixes several bugs and makes user interface improvements. This update also adds dual division event support for POWERPLAY. This update is REQUIRED for all events, including dual-division events.
Important Notes for the POWERPLAY season
- The referee & scorekeeper inputs are from the SCORING SIDE perspective (BEHIND THE FIELD). Make sure your scoring referees are on the scoring side of the field.
- Referees are scoring a side of the field, not an Alliance. They enter the scoring state for both red and blue on their half of the field. The X Junction column is entered by both referees, and both must agree.
- The Junction edit popup on the Match Control page is alliance-agnostic. Edits to junctions affect both alliances.
- The displays show a grid that indicates ownership of junctions & circuits. It is oriented to match the configuration of the display. The standard configuration will display the grid from the Audience perspective. This is opposite the referee and scorekeeper! A display that is configured for "Red on Left" will display the grid from the scoring perspective. Be sure to set this configuration properly for streams where the camera is behind the field.
- With the MatchMaker update in v4.1.6, some Windows users may see a "Security scan required" notification when you run MatchMaker. MatchMaker should continue to run properly during or after the scan. If you run into problems generating a qualification schedule, please contact support. Do not attempt a DIY solution for a schedule generation issue.
Detailed Change Log
- Add cone counts and beacon indicator to referee and head referee tablets. Will now show, e.g.,
R: 5 B: 10▲
, indicating the junction has a total of 5 Red Cones, 10 Blue Cones, and a Blue Beacon.- This does not give any information on order of the Cones and is meant only as a double-check for referees.
- Add Junction type labels to referee tablets, i.e.
Z1(G)
- Add overlay-style randomization display
- For dual division events, mirror inspection status between the divisions and the parent event
- Add API websocket events for
SHOW_PREVIEW
,SHOW_RANDOM
, andSHOW_MATCH
- Fix bugs with referee tablets that are assigned to all fields switching matches mid-match and some other related field binding bugs
- Fix rendering of team lists when team names include single quotes
- Fix labeling team Beacons on head referee tablet
- Consistently label Junctions across all pages
- Delay starting <C29> timeouts until the animation has finished