Releases: FIRST-Tech-Challenge/scorekeeper
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
FIRST Tech Challenge Live v4.1.8
This update fixes several bugs and makes some user interface improvements. This update is strongly recommended for all 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
- Show selected randomization value on autonomous referee page
- Flip terminal order on driver-controlled score entry page to match field orientation
- Fix scoresheet pdfs displaying "500 Internal Server Error"
- Fix booting the scoring system when disconnected from all networks
- Fix scanning a QR code twice sometimes clearing valid inspection checkmarks
- Fix clearing <C08> timeouts on commit of the previous match
FIRST Tech Challenge Live v4.1.6
This update fixes a few small bugs and updates the MatchMaker builds for 64-bit ARM Linux distributions. This update is strongly recommended for all events, and is required for events running the scoring system server itself on 64-bit Raspberry Pi OS.
Please read the v4.1.1 Release Notes for details on the latest features and changes.
With the MatchMaker update, some Windows users may see a "Security scan required" notification similar to the one below 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.
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.
Detailed Change Log
- Improved warnings about inability to sync data when an unregistered/unpaid team is added. A warning banner will appear on the Edit Team List page and the Schedule Generation Page if unpaid teams are added. (The event can still run, but results will not display correctly online until the team has registered & paid)
- Update MatchMaker to v1.5.0
- Fix some E5 Plays being scanned as "Unknown Device"
- Fix Timeout timers lingering through match start
- Fix alt QR workflow on older devices
- Fix alt QR handling of bad scan
- Don't scroll ref pages on failed/early submits
- Fix duplicate "Robot Sizing Inspection" section on hardware inspection. Note: any events that were downloaded or imported into an instance of any version of the traditional scoring system before November 1 may still have the duplicated section, even if reimported into this version.
FIRST Tech Challenge v4.1.5
This is a REQUIRED update for all events. It fixes a bug where the Junctions were rendered incorrectly on the scoresheet views.
Please read the v4.1.1 Release Notes for details on the latest features and changes.
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.
Detailed Change Log
- Fix junction rendering order in scoresheets
- Fixes support chat bugs that occurred when run on newer versions of Java
- Fixes embedded scoresheets & scoresheet printing
FIRST Tech Challenge Live v4.1.1
This is the first official release of the FIRST Tech Challenge Scoring Software for POWERPLAY.
Please read the v4.0.2 Release Notes for details on the following new features for POWERPLAY:
- Field Inspection Automation
- Training Matches
- Qualification Schedule Activation
The v4.0.7 Release Notes detail the timeout changes as described in <C29>.
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.
New Features
- Referee Timeout Timers - The referee page will show appropriate timeout timers at the top of the page. They can be expanded into a full-screen version, turning the tablet into a portable timeout timer.
- Parallel League Meet Ranking Updates - If two meets from the same league are running at the same time & both are connected to the internet, they will receive each other's ranking updates. This means that teams' league rankings shown on the Preview, Results, and Pit Display screens will be up-to-date and more reflective of what is shown online.
- Display Config from Control Page - The "Connected Displays" table on the "Video Switch" tab now has a "Config" button, which will open the config dialog. This will allow changes to the settings on a display that is open on a different device.
- Previous Event Inspection Comments - A button at the bottom of an inspection form will bring up a dialog containing any comments from previous inspectors
- ftc-events link QR on Pit Displays - look for the "Show QR" option in the Pit Display settings. Will only show if the event has successfully synced with HQ
- POWERPLAY Win Animations!
Detailed Change Log
- Added timeout timers to referee pages
- Syncs league rankings with any concurrently-running meets
- Update Win Animations
- Option to show QR link on Pit Display
- Remotely configure displays from the Control Page
- Referee lag indicator only colors the background - no longer leaks through inputs
- Fix bug where the totals were shown incorrectly on the Control Page's Schedule tab
- Schedule tab totals reset to 0 immediately on replay
- Fix bug where the ref pages would stay at the bottom of the page during a phase transition
- Fix MatchMaker running on newer Macs - updated Windows & Mac executables to v1.4, which is properly notarized
- Fix several CORS issues in the public API
- Fix unmute warning appearing on Pit Displays
- Fix error with Test Matches when using real teams
- Show event name on Display Config dialog
FIRST Tech Challenge Live v4.0.7 (Preview)
This is a preview release of the FIRST Tech Challenge Scoring Software for POWERPLAY.
THIS VERSION CANNOT BE USED FOR OFFICIAL EVENTS.
Please read the v4.0.2 Release Notes for details on the following new features for POWERPLAY:
- Field Inspection Automation
- Training Matches
- Qualification Schedule Activation
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.
New Features
Referee Page Input Updates
The referee input has been updated based on user & tester feedback. The top buttons now only toggle between Cone, Beacon, and Remove, while alliance-specific buttons are now inside the cells. The stacks are now centered in each cell, with a +Red button to the left and a +Blue button to the right. For Beacons, there is a button in each corner for the corresponding teams.
Taller stack will wrap:
Eliminations Timing Changes (<C29>c)
The changes to Elimination Timings have been implemented:
-
Alliance Timeout has been removed
-
Field Timeout button is only available during Qualification Matches. It starts a 5 minute timer (<C08>).
- If Head Referee page is in use, the Field Clear can be used as the starting point
- Ending a Field Timeout requires confirmation via popup
-
Eliminations timeouts are automatically started and displayed. When a match is posted for the first time, an 8 minute timer is started.
-
When and where the timeouts are shown depends on field count, display binding, and active series:
- Finals (Or once one semifinal is complete):
- Will show on all Field Displays and Audience Displays
- Semifinals
- 1 Field Events - displays will only show the timer if both SF are in timeout
- 2 Field Events:
- Will only show the timer on the applicable field-bound display (The SF1 timer will only show on field 1)
- If both SF in timeout, unbound displays will show the lowest timer (the one that will expire first)
- Finals (Or once one semifinal is complete):
-
Timeout warning sound moved to 1 minute before expiration
-
At events with 3 team alliances, the Field Display will show a "Lineup Window" timer below the timeout timer showing the time to inform a referee of the teams in the match (4 minutes from last post by <C29>b.ii)
Not Yet Implemented / Updated
The following have not been updated for this preview:
- Winner Animation
- Some Manuals/Resources (such as the Scorekeeper Manual)
Detailed Changelog
- Referee junction inputs update
- Eliminations Timing Updates
- Awards scripts updated
- Head Referee Timing Tab updated for timing changes - Alliance Timeouts removed, Field Clear only applies to Qualification Matches
- Fixed bug in the Control Page's Display Tracking - closing a display will now update properly
- Fixed bug where Field Displays wouldn't show Finals
- Fixed bug where Alliance Selection could not be reset until after it was completed
- Fixed headers in OPTION pre-flights on API routes
- The "Manage Server" page's IP Address section now allows overriding the IP shown in the header of every page. It lists each IP the system found and allows the selection of the one to show:
FIRST Tech Challenge Live v4.0.2 (Preview)
This is a preview release of the FIRST Tech Challenge Scoring Software for POWERPLAY. THIS VERSION CANNOT BE USED FOR OFFICIAL EVENTS.
Important Notes for the POWERPLAY season
- The referee & scorekeeper inputs are from the SCORING SIDE perspective (ie 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.
New Features
Field Inspection Automation
Starting with version 8.0.0 of the FTC SDK, the Driver Station's Robot Controller Inspection Report will display a QR at the bottom of the page that can be scanned by Field Inspectors using the Scoring System. This QR contains information that allows the scoring system to automatically check 18 of the checkboxes on the Field Inspection form. On the Field Inspection page, there is a "Scan QR" button. Tapping it will open the native camera app. Take a picture of the DS with the QR in focus and the scoring system will read the QR data and apply the checks it can validate.
Note: this does not "scan" the QR - it will not automatically detect the QR and take the picture; please ensure that the QR is in focus so that it can be read once the picture is taken.
After scan, it will provide a summary of how many items were checked, and what items were not able to be checked:
Prior to scanning, ensure the robot is on & connected, and the gamepads are plugged in to the Driver Station. If scans fail, try backing the camera away from the QR, or increase the DS brightness, or set the DS to portrait mode.
There is an alternate page for QR scanning outside the scope of an inspection form. It is made to be more phone-friendly and allows scanning of any team. The alternate workflow is accessed from the Field (Tabletop) Inspection Team Select. Events can consider using this workflow when:
- An event is scanning the QRs at a different location from Tabletop Inspection (either as a stop on the way to Field Inspection or a mobile inspector in the pits)
- The event's (or inspector's) devices do not have cameras. In this scenario, a phone is used to scan the QR, then the form is opened on the tablet to do the rest of inspection, either by the same or a different inspector/location.
When scanned from the alternate workflow, the checkboxes are still checked, but the team's inspection status is not affected (not set to IN_PROGRESS). It can also be used as a report of teams that have scanned:
Training Matches
Test Matches can now be marked as "Training" Matches when they are created. During a Training Match, the referee pages will show dialogs that walk through the different screens and briefly describe how to score. We strongly recommend every event run at least one Training Match with all the referees before Matches start.
The Test Match dialog has a "Training?" checkbox. To add a Test/Training Match, on the control page, go to "Settings", then "Enter Test Mode", then "Add Test Match":
The ref page will show info for each scoring item:
Qualification Activation
After the MatchMaker run is complete, there is now an additional step to "Activate" the Qualification schedule. The schedule is not shown publicly nor will the match control page load the schedule until it is activated.
This is intended to give events that wish to do so time to print the schedules before they are available online. DO NOT RUN MATCHMAKER UNTIL EVERY TEAM HAS PASSED INSPECTION!
Not Yet Implemented / Updated
The following have not been updated for this preview:
- Eliminations timing changes (<C29>c)
- Head Referee Timer Tab
- Award Scripts
- Winner Animation
- Some Manuals/Resources (such as the Scorekeeper Manual)
Detailed Changelog
- Game-specific pages updated POWERPLAY
- Rankings are now averaged (GM1 § 5.1.1)
- League Rankings are always shown with a divisor of 10. (GM1 § 5.2.1.2)
- Field Inspection Automation - QR scanning to automate parts of Field Inspection
- Field Inspection Dropdowns - the DS & RC device "circle" items on the Field Inspection Checklist are now dropdowns to select the device. The "Unknown Device" option will still allow the form to be marked as passed.
- Field Inspection Split Renamed - When split, Field Inspection becomes "Tabletop Inspection" and "Robot Operation Inspection". Tabletop Inspection uses the first three groups of the form, while Operation uses the last two. If split, the QR link will appear on the Tabletop form.
- The Inspection Status Grid will now update immediately when a team's status changes
- Inspection Progress - A progress bar with percentage labels is shown above the non-projected inspection status grid
- Referee pages will blink yellow if the referee is lagging too much - 8 seconds past autonomous (start of Driver-Controlled) or 10 seconds past match end.
- The MatchMaker Progress Bar is now accurate. It is now tied to MatchMaker's actual progress instead of predicted progress.
- Qualification Match Schedule Activation Step
- Display Tracking on Match Control "Video Switch":
- Shows the state and config of all connected displays - should make it easier to check and find displays
- There is a bug in this build where a closed display does not disappear - this has been fixed for the next release