{"id":18183622,"url":"https://github.com/paddockbux/novacolumnv2","last_synced_at":"2026-05-18T10:39:33.177Z","repository":{"id":260693004,"uuid":"868291360","full_name":"PaddockBux/NovaColumnV2","owner":"PaddockBux","description":"NovaColumn - Minecraft Server Scanner","archived":false,"fork":false,"pushed_at":"2025-02-18T20:32:09.000Z","size":56,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T11:47:37.516Z","etag":null,"topics":["mariadb","masscan","minecraft","scanner","server-scanner"],"latest_commit_sha":null,"homepage":"https://novacolumn.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PaddockBux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-06T01:38:43.000Z","updated_at":"2025-03-30T19:02:33.000Z","dependencies_parsed_at":"2024-11-01T22:17:58.222Z","dependency_job_id":"c6ac7139-91e1-4415-a2be-441d91b7edec","html_url":"https://github.com/PaddockBux/NovaColumnV2","commit_stats":null,"previous_names":["paddockbux/novacolumnv2"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PaddockBux/NovaColumnV2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaddockBux%2FNovaColumnV2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaddockBux%2FNovaColumnV2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaddockBux%2FNovaColumnV2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaddockBux%2FNovaColumnV2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PaddockBux","download_url":"https://codeload.github.com/PaddockBux/NovaColumnV2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaddockBux%2FNovaColumnV2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278266894,"owners_count":25958733,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mariadb","masscan","minecraft","scanner","server-scanner"],"created_at":"2024-11-02T20:03:38.998Z","updated_at":"2025-10-04T04:58:25.838Z","avatar_url":"https://github.com/PaddockBux.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NovaColumnV2\n\nNovaColumnV2 is an educational tool that uses [masscan](https://github.com/robertdavidgraham/masscan) to scan the internet for Minecraft servers.\\\nWe have created a web UI that our main [website](https://novacolumn.com) provides as a demo, you can find the repo [here](https://github.com/PaddockBux/NovaColumn-WebUI).\n\n## Disclaimers\n\nNovaColumn is provided as-is and does not contain any warranty.\\\nThis is a very dangerous tool that can get your internet blocked if abused.\\\nWe do not take responsibility for any damages caused by using this tool.\n\n## Prerequisites\n\nNovaColumn requires Python3.8+ and a MariaDB server with a user that requires the following privileges:\n\n- SELECT\n- INSERT\n- UPDATE\n- CREATE\n- INDEX\n\nThe script will create the necessary tables and columns for you if they do not exist.\n\nPython libraries are also supplied in the requirements.txt file. To install, run either `pip install -r requirements.txt` or `python -m pip install -r requirements.txt`.\n\n## Installation\n\nClone the repo using `git clone https://github.com/PaddockBux/NovaColumnV2` and then run the script in the adjacent directory using `python ncv2.py`.\n\n## Usage\n\nNCV2 drops a config file on first run (unless you manually pass database credentials using the arguments). Just simply run the script and it will drop a file named `novacolumn.conf` in the same directory. Included is the entries for credentials used to interface with the MariaDB server.\n\nAfter creating and filling out the configuration file, you're ready to use NCV2.\\\nTo use NCV2, run masscan with a json output (`-oJ \u003cfilename\u003e.json`). When masscan is completed run NCV2 with the output file: `python ncv2.py \u003cfilename\u003e.json`.\n\nInformation about arguments are shown when the `-h` argument is added.\n\n```Text\nusage: ncv2.py [-h] [-u] [-v] [-t THREADS] [-m TIMEOUT] [-e] [-c] [-a] [--dbusername DBUSERNAME] [--dbpassword DBPASSWORD] [--dbhost DBHOST] [--dbport DBPORT] [--dbname DBNAME] [file]\n\n               _   __                 ______      __                    _    _____\n              / | / /___ _   ______ _/ ____/___  / /_  ______ ___  ____| |  / /__ \\\n             /  |/ / __ \\ | / / __ `/ /   / __ \\/ / / / / __ `__ \\/ __ \\ | / /__/ /\n            / /|  / /_/ / |/ / /_/ / /___/ /_/ / / /_/ / / / / / / / / / |/ // __/\n           /_/ |_/\\____/|___/\\__,_/\\____/\\____/_/\\__,_/_/ /_/ /_/_/ /_/|___//____/\n                                        NovaColumn V2\n          Programmed by \u0026 main ideas guy: GoGreek    ::    Co-ideas guy: Draxillian\n\n       Fair warning, calling the update function will take a while on large databases!\n\npositional arguments:\n  file                  the path to the .json file to be parsed.\n\noptions:\n  -h, --help            show this help message and exit\n  -u, --update          ping/Update the current servers in the database. (does not require a file)\n  -v, --verbose         enable verbose mode to print detailed logs.\n  -t THREADS, --threads THREADS\n                        the amount of threads to process the file with. (4 default)\n  -m TIMEOUT, --timeout TIMEOUT\n                        the timeout speed for the servers, read the README for more info. (0.3 default)\n  -e, --external        used for when the database is not on the same machine. (only applies for --update)\n  -c, --verify          verify all playernames in the database. (does not require a file)\n  -a, --altapi          verify using the official Mojang API instead of Mowojang. (only applies for --verify)\n  --dbusername DBUSERNAME\n                        pass database username via argument.\n  --dbpassword DBPASSWORD\n                        pass database password via argument.\n  --dbhost DBHOST       pass database host via argument. (default localhost)\n  --dbport DBPORT       pass database port via argument. (default 3306)\n  --dbname DBNAME       pass database name via argument. (default 'novacolumn')\n\nExample usage:\nVerbose\n    nc2 -v input.json\nUpdate the database\n    nc2 -u\nUse multiple threads\n    nc2 -t 10 input.json\nChange timeout \u0026 threads\n    nc2 -m 2.3 -t 10 input.json\n\nFor more information, check the README file.\n```\n\n## Contributing\n\nPull requests must be clear about what's added.\\\nIf you want to add a new feature, please open an issue or send a message in our Discord server channel #suggestions to discuss. Issues with no clarification or reason (add x because yes) will be rejected.\n\n## License\n\nThis project is licensed under the AGPL-3.0 License - see the [LICENSE](./LICENSE) file for details.\n\n## Contact\n\nIf you need help with utilizing NCV2 or just want to see plans and updates, join our [Discord server](https://discord.gg/FtSqu7FzHJ).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaddockbux%2Fnovacolumnv2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaddockbux%2Fnovacolumnv2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaddockbux%2Fnovacolumnv2/lists"}