Troubleshooting
How to use
Below you will find multiple tables covering different topics related to Material Plane.
For easy navigation, each table can be found in the table of contents on the left.
Pick the table that best corresponds with your issue, if you cannot find your issue there, make sure it's not located somewhere else.
If your issue is nowhere to be found, or you found a solution that isn't mentioned here, please contact me.
Issues can have multiple causes or multiple solutions.
If you find a row that does not mention an issue, it relates to the issue in the row above it.
Similarly, if you find a row that does not mention a possible cause, it relates to the issue and possible cause of the row above it.
Sensor
| Issue | Possible cause | Possible solution | More info |
|---|---|---|---|
| Sensor can't detect base/pen | Sensor sensitivity set incorrectly | Properly configure the sensor | link |
| Sensor can't detect base/pen at edge of display | Sensor sensitivity set incorrectly | Properly configure the sensor | link |
| Sensor too close to the display | Properly configure the sensor | link | |
| Sensor detects a lot of noise | Minimum brightness set too low | Increase minimum brightness | link |
| Too much infrared noise in room | Switch all infrared sources off, such as: -Wii sensor bar -VR stations/receivers |
||
| Prevent direct sunlight on the sensor/display/table | |||
| Make sure there are no lights shining/reflecting directly into the sensor | |||
| Sensor can't detect complete display | Sensor too close to the display | Move sensor further back | link |
| Install a wide-angle lens | link | ||
| Sensor won't charge | Sensor is not getting (enough) power | Connect USB cable to power adapter | |
| Try a different power adapter | |||
| Broken cable | Replace cable | ||
| Sensor can't connect to WiFi | Wrong credentials | Enter correct credentials | |
| No 2.4GHz WiFi available | Make sure there's 2.4GHz WiFi available | ||
| Router too far away | Move router or sensor closer, or get a WiFi extender | ||
| Detected points move in wrong direction | Mirroring and/or rotation not configured properly | Properly configure mirroring and/or rotation | link |
| Incorrect battery readings | Battery has been replaced | Reset battery configuration | link |
| Bug | Reset battery configuration | link |
Base
| Issue | Possible cause | Possible solution | More info |
|---|---|---|---|
| Base won't update | Both the pen and base are connected to the dock | Remove one of them | link |
| Faulty USB-C cable or USB port | Try a different cable or USB port | ||
| Incorrect or no USB drivers installed | Install the drivers | link | |
| Base won't charge | Dock is not getting power | Apply power to the dock | |
| Dock is getting insufficient power | Try a different power adapter that can supply enough power | link | |
| Too many dock expansions stacked | Try removing dock expansions | link | |
| Base not seated correctly | Try reseating it | link | |
| Base won't detect touch | Base switched off | Switch base on | link |
| Touch sensitivity set too low | Increase touch sensitivity | link | |
| Wrong (pen?) firmware installed | Install the correct firmware | link | |
| Base won't go into standby (LED always on) | Base is in 'Always On Mode' | Switch base back to 'Normal' mode | link |
| Touch sensitivity set too high | Decrease touch sensitivity | link | |
| Base becomes active when placed on display | Touch sensitivity set too high | Decrease touch sensitivity | link |
Pen
| Issue | Possible cause | Possible solution | More info |
|---|---|---|---|
| Pen won't update | Both the pen and base are connected to the dock | Remove one of them | link |
| Faulty USB-C cable or USB port | Try a different cable or USB port | ||
| Incorrect or no USB drivers installed | Install the drivers | link | |
| Pen/ won't charge | Dock is not getting power | Apply power to the dock | |
| Dock is getting insufficient power | Try a different power adapter that can supply enough power | link | |
| Too many dock expansions stacked | Try removing dock expansions | link | |
| Pen not seated correctly | Try reseating it | link |
Calibration
| Issue | Possible cause | Possible solution | More info |
|---|---|---|---|
| Can't perform/complete calibration | Active user not configured correctly | Configure active user | link |
| Active user not connected to Foundry | Connect active user | ||
| Sensor not connected | See above | ||
| Sensor sensitivity not set correctly | Configure sensor | link | |
| Base not enabled | Switch on base | ||
| Sensor can't see entire display | See above | ||
| Tokens don't stay directly below base | No calibration performed | Perform calibration | link |
| Calibration disabled | Enable calibration | link | |
| Calibration not done correctly | Perform calibration, make sure you check Base Orientation | link | |
| Sensor offset and/or scaling set incorrectly | Correctly configure offset and/or scaling | link | |
| Detected points move in wrong direction | Mirroring and/or rotation not configured properly | Properly configure mirroring and/or rotation | link |
Foundry VTT
| Issue | Possible cause | Possible solution | More info |
|---|---|---|---|
| Can't see module in Foundry's module page | No internet connection | Make sure you are connected to the internet | |
| Foundry server down | Wait until the server is up again | ||
| Incompatible Foundry version | Upgrade/downgrade to a compatible version | ||
| Bug in the module | Report it to me | ||
| Bug in Foundry | Report it to the Foundry team | ||
| Can't install module | Bug in the module | Report it to me | |
| Bug in Foundry | Report it to the Foundry team | ||
| Can't update module | No internet connection | Make sure you are connected to the internet | |
| Incompatible Foundry version | Upgrade/downgrade to a compatible version | ||
| Bug in the module | Report it to me | ||
| Bug in Foundry | Report it to the Foundry team | ||
| Sensor won't connect to module | Sensor not connected to WiFi | Connect sensor to WiFi | link |
| Incorrect 'Connection Mode' selected | Select correct mode | link | |
| Incorrect 'Sensor Module IP Address' configured | Configure correct address | link | |
| Foundry server is secured | Connect through Material Companion | link | |
| Tokens don't move | Sensor is not connected to WiFi | Connect sensor to WiFi | link |
| Sensor is not connected to module | Connect sensor to module | link | |
| Sensor is not correctly calibrated | Perform calibration | link | |
| Sensor mirroring/rotation not configured correctly | Configure mirroring and/or rotation | link | |
| Sensor sensitivity is not set correctly | Configure sensor | link | |
| Token is not owned by display user | Make display user owner of token | link | |
| Enable 'Non-Owned Movement' | link | ||
| Wrong tokens are being moved | Sensor not correctly calibrated | Perform calibration | link |
| Sensor mirroring/rotation not configured correctly | Configure mirroring and/or rotation | link | |
| Tokens don't stay directly below base | Sensor not configured properly | Configure sensor | link |
| Tokens are not dropped after releasing base | Module is configured to not drop tokens | Enable 'Delect Token After Drop' | link |
| Tokens can move through walls | This is a known issue that has been hard to solve | Try to avoid having walls through the middle of a grid space | |
| Detected points move in wrong direction | Mirroring and/or rotation not configured properly | Properly configure mirroring and/or rotation | link |